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The editor speaks. 



Welcome subscribers! I wish to take 
this opportunity to thank you all for 
subscribing* and to reassure you that 
this magazine will continue to be pub- 
lished for a MINIMUM of two years. 
Tliat is my personal commitment to 
you. If you enjoy the content enough to 
continue subscribing, then of course it 
will stay around much longer, some- 
thing that I would very much like! We 
are currently growing steadily at around 
20 new subscribers per month. Note 
that these are PAID IN FULL subscrip- 
tions, not just names on a free mailing 
list. If this rate continues, we will be 
publishing for quite a while! Should the 
time come that publication must cease, 
I WILL let you know several issues in 
advance. I do not like getting an unex- 
pected last issue, and don't intend to 
give one if reasonably avoidable. In 
such a case, subscriptions will either 
be continued out or refunds issued. 

The following is the tentative publica- 
tion schedule: 
01 August 
IS September 
01 November 
15 December 
01 February 
15 March 
01 May 
15 June 

Subscribers should receive their maga- 
zine within seven days before or after 
the above dates (i.e.- this issue should 
have been received between 26 July 
and 07 August). I will let you know of 
any changes in this column. 

A lot has happened in the CoCo com- 
munity since "the Rainbow^ceased pub- 
lication in May. TheiehavebeenTHREE 
CoCoFests. Several new products have 
been introduced. You will find news 
concerning the Tests in the very first 
article. New products are discussed in 
"micro News". 

If you have never attended a Pests, 
don't forget that the annual Atlanta 
CoCoFest is tentatively scheduled for 
the first weekend in October. Now is a 
good time to make plans to attend! 



Several new authors appear in this issue 
as well as a few familiar names. If you 
have something you wish to share with 
the community , please drop us a note in 
the mail or call one weekend. You don't 
have to be a first rate author to have 
something printed! Just explain your 
article as best you can in writing. If 
there is something I don't understand, 
111 give you a call! It is that simple, but 
you must make that first contact! "68* 
micros" can always use interesting pro- 
grams, hardware modifications, and 
general articles. And I desire your criti- 
cisms and suggestions for improve- 
ments also! After all, this is YOUR 
magazine! 

"the world of 68' micros" is not the first 
magazine to combine 6800 series and 
68000 series Motorola processor in- 
formation under one cover. That honor 
belongs to the long defunct "68 Micro 
Journal", often referred to as "68 Mi- 
cro". 268*m (my pet abbreviation... it is 
actually a play on i286...) is not a rein- 
carnation of "68 Micro". The name was 
not chosen because of a resemblance 
either. We can only hope to become as 
well known and respected as "68 Mi- 
cros" has been. 

Remember, 268'm is not limited to any 
single platform! If you use OS-9 on an 
Atari ST or Macintosh, one of the FHL/ 
IMS/PT machines, or the CoCo, you 
have a reason to subscribe. We support 
ANY programming language that runs 
under OS-9 or the CoCo's native BA- 
SIC (disk or tape!). Programs are ac- 
cepted for all! So what are you waiting 
for... an invitation to write? Well, this 
is it! Note that a "letters" column will 
begin in the next issue* so let us know 
how we are doing. 

Please enjoy this premeire issue. Pass 
it around and encourage your friends to 
subscribe also. Send in your comments 
and articles. And when the time comes, 
I hope you will find that the magazine 
has proven interesting enough to con- 
tinue your subscription... 

Francis G. Swygert 
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A Great Year for CoCoFests! 



EG. Swygert 



There will be no less than FOUR 
CoCoFests this year! Three have al- 
ready passed (reviews follow) while 
one is yet to be... so you still have time 
to get in on the fun! 

J^t's start this article with the chance 
to attend a Test this year.. The Fourth 
Annual Atlanta CoCoFest (02-03 
October, 1993). The Atlanta Computer 
Society, the oldest computer club in 
Atlanta (and possibly the U.S.A.!), has 
been hosting a Test for the past three 
years. The location is the Northlake 
Holiday Inn, Exit 28 of 1-285 (LaVista 
Road/Hwy 236). Head toward down- 
town Atlanta from the Interstate and the 
Holiday Inn entrance will be to the 
right. There are several other motels 
and many fast-food restaurants in the 
area, as well as Northlake Mall. Last 
year's Test was great, with around 200 
attendees and 20 vendors. This year 
should be at least as good, if not better! 
Rooms will be $52 (CoCoFest rate), 
booths $25. For more information con- 
tact ACS, c/o Alan Dages, 4290 Bells 
Ferry Road Suite. 10639, Kennesaw, 
GA 30144; phone 404^69-5111; club 
BBS 404-636-2991. 

Three CoCoFests have already tran- 
spired this year. Even when Rainbow 
Magazine was sponsoring the Tests, 
there were not this many in one year! 

The most recent Test was the Third 
Annual Pacific North West (PNW) 
CoCoFest held June 25-26. This Test 
is sponsored by the Port O' CoCo club 
of Port Orchard, Washington (south 
west of Seattle, across Puget Sound; 
just south of Bremerton). 

In an attempt to increase attendance, 
other computer types were invited to 
attend. The show was predominantly 
CoCo (about 60%), but representatives 
with Apple, Commodore, and PC com- 
puters had displays also. This doesn't 
sound like a bad idea... maybe an "or- 
phan" computer show would draw a 
much bigger crowd and make the show 
more worthwhile for the sponsors. 



The PNW *Fest has always been a small 
one. Approximately 75-80 people 
showed up to view the new products. 
Though only a few vendors were 
present, many products were repre- 
sented Andre LaVelle of SBUG had 
made arrangements at the Chicago fest 
to represent vendors who wouldn't be 
able to attend (such as myself) due to 
the distance. Andre was given a small 
percentage of sales, but his service was 
much more valuable than any remu- 
neration he received, both for the ven- 
dors represented and the users who 
may not have seen the products. 

The items that received the most atten- 
tion were Burke & Burke's "Rocket" 
prototype (first seen in Chicago) and 
"Power Boost" OS-9 Level 2 upgrade 
for the 6309, and also Gale Force's 
rival OS-9 Level 2/6309 upgrade, 
"NitrOS9". The Gale Force upgrade 
is the lesser known, but is more exten- 
sive the B&B upgrade. Gale Force dis- 
assembled nearly every module of OS- 
9 by hand and then reassembled with 
modifications taking advantage of the 
6309's capabilities. No accurate com- 
parisons have been done between the 
two to this date. 

The following vendors were able to 
attend the PNW Test- 
Burke & Burke 
Atlanta Computer Society 
Gale Force 
Bob van der Poel 
South Bay Users Group (SBUG) 

It is hoped that the organizers of this 
event might be able to move it across 
Puget Sound in the greater Seattle area 
next year. This would probably increase 
attendance. Personally, I wouldn't mind 
sharing the floor with some of the other 
"orphan" computers also... sounds like 
a very good idea, and a way to get some 
more assistance from other user 
groups. We orphans need to stick to- 
gether also! 

For information on next year's event, 
contact Port O' CoCo, c/o Donald 



Zimmerman, 3046 Banner Road, Port 
Orchard, WA 98366-8810; phone 206- 
871-6535 

The Second Annual "Lasf ' Chicago 
CoCoFest was held May 1-3 at the 
Holiday Inn of Elgin, just west of Chi- 
cago. The name comes from the fact 
that the year before (1992) CoCoPRO! 
sponsored it's last "Fest in Chicago. 
Well, the Glenside CoCo Club (the co- 
sponsor of 1992, sponsor for 1993) 
sort of picked up on the name as a joke 
and continues to call each Test the 
"last" . There will be more to come, with 
next year already in planning! 

This year there were a total of 30 ven- 
dors! Several clubs were represented 
in that total, among them the Overseas 
OS-9 User Group Consortium. This 
booth had representatives from Aus- 
tralia, Japan, Switzerland, and the Neth- 
erlands. There was a conference during 
the Test concerning the future of OS- 
9. One item of interest that came up 
during this conference was the number 
of OS-9 users overseas. It has often 
been quoted that OS-9 was more popu- 
lar overseas than in the U.S. Well, it 
turns out that this is not true! The Japa- 
nese, European, and U.S. user groups 
all have approximately 300 members 
each, while the Australian group is a bit 
smaller. 

Several new items of interest were 
shown for the first time in Chicago: the 
Disto 2MB upgrade, Burke&Burke's 
"Rocket" 68000 CPU board for the 
CoCo, Sub-Etha'spull-down menu user 
interface for OS-9/OSK, CoNect's su- 
per high speed serial port, and the book 
Tandy'slittle Wonder" and a four page 
flyerfor"the worldof 68* micros" maga- 
zine from FARN A Systems (read more 
about these items in "Micro News"). 

Vendors Attending Chicago 'Fest: 

Atlanta Computer Society 

Adventure Survivors 

BARSoft 

Burke&Burke 

Chicago Area OS-9 Users Group 
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CoIorSystems 
CoNect 

Cook County CoCo Club 
Dave & Nancy Myers 
Delmar 
Disk N' Dat 
Disto 

FARNA Systems 
Frank Hogg Laboratories 
Glenside CoCo Club 
HawkSoft 

Interactive Media Systems (IMS) 
Kala Software 

Dirt Cheap Computer Stuff Co. 
OS-9 Users Group, U.S .A. 
Overseas OS-9 User Group Consor- 
tium 

Microware 
Radical Electronics 
South Bay Users Group (SBUG) 
StG Net 
StrongWare 
Sub-Etha Software 
Sundog Systems 
T&D Software 
Lee Veal 

Contact Glenside CoCo Club, p/o Tony 
Podraza, 119 Adobe Circle, 
Carpentersville, IL 601 10-1 101; phone 
708-428-3576 for information on the 
Third Annual "Last" Chicago CoCoFest 
Carl Boll, a club officer, can also be 
contacted via Delphi, usemame CBJ; 
Internet cbj@delphi.com . The club sup- 
ports a BBS at 708^28-0436. 



The first Test of the year was hosted by 
Mid Iowa & Country CoCo club. This is 
a national club with members all over 
the U.S. and Canada, as well as a few 
overseas. Des Moines, also home to 
Microware, was the scene of the March 
27-28 event. 

The "Middle America" 'Fest was 

rather small, with eleven vendors sched- 
uled but only nine making it. Burke & 
Burke had made plans to attend, but had 
to cancel at the last minute, as did Zebra 
Systems. Part of the reason for the low 
attendance (roughly 75 attendees) was 
due to the close date of the Chicago 
Test. Only 33 days and approximately 
350 miles separated the two events. 
Many vendors and CoCo supporters 



simply had to choose between the 
events. Those who had a long distance 
to travel chose the Chicago event, since 
it has long been THE CoCo event to 
attend. Hopefully more can be done to 
separate the events by at least two 
months, as the effort put out by 
MI&CCC was respectable. At least 
Terry Simons, president of the club, 
reports that the club didn't lose any 
money, and there should be an event 
planned for next year. Contact Terry at 
1328 48th Street, Des Moines, I A 
50311; phone 515-279-2576; Delphi 
username MRUPGRADE; Internet 
mrupgrade@delphi.com. 

A neat attraction at Middle America 
was the presence of a couple of people 
from Microware- M. Hawkings and T. 
Earls. The names should sound famil- 
iar... they are two of the three people on 
theCoCo 3 CTRL-ALT-RESETscreen! 
The third person left Microware after 
the CoCo 3 project to work for - ugh - 
Micrsoft A DS-69B was set up and 
connected to a laser printer using the 
HP Ink Jet printer driver. One could 
have their picture taken and a disk file 
would later be sent (for $3) so that one 
could be the third person in their CoCo 
(after a ROM was burned)! 

Vendors Attending Mid America Pest: 
Atlanta Compute- Society 
Glenside CoCo Club/Chicago Test 
Mid Iowa & Country CoCo Club 
South Bay Users Group (SBUG) 
Sportsware, Inc. 
StG Net 

Sub-Etha Software 
Sundog Systems 
Dave Wordell 



If you have never been to a CoCoFest, 
try to make plans to attend one! Not 
only is there lots of new and used hard 
and soft ware, but there are also many 
free, interesting seminars. If there isn*t 
one in your area, maybe you could en- 
list the aid of a local club and have one. 
Any of the above hosts as well as the 
editor of this magazine would be will- 
ing to give advice and assistance. Do 
remember that there should be some 
time and distance between the Tests. A 



California Test at the same time as the 
Atlanta Test shouldn't impact many 
attendees, but will impact some of the 
major vendors. Keep this in mind when 
planning! The two established Tests, 
Atlanta and Chicago, will most likely 
be the most attended by vendors for 
some time to come. Who knows, maybe 
1*11 see you in Atlanta this year! Since 
Atlanta is practically in my back yard 
(about 150 miles north of Warner Rob- 
ins), FARNA Systems will definitely 
be there! 

Tips for planning a successful Test; 

* Plan far in advance! You need to start 
getting the word out to vendors and 
attendees at least six months before the 
planned date. This means a lot of foot 
work must be started almost a year 
before the planned date, especially site 
negotiations. 

* Choose a site that is easily accessible 
to a large number of people. You will 
draw a lot of walk-ins that way, people 
who may normally stay home, as they 
aren't the CoCo die-hards that "we" are! 

* Advertise in as many publications as 
possible, even local papers. You'd be 
surprised how many closet CoCo users 
there are! You might even entice some- 
one to bring theirs back out.. 

* Consider inviting local Apple, Com- 
modore, Texas Instruments, Adam, and 
other"oiphan" makes to join you. ItwiU 
make the event bigger and more attrac- 
tive to a hotel to host. Personally, Td 
leave the Macs and PCs out, as they 
tend to overshadow everything else... 

* Keep costs down! Some of us travei 
great distances to attend a Test A small 
Test doesn't have to be at a Holiday Inn, 
a cheaper hotel will do nicely. An alter- 
native is to put phone numbers of lower 
cost hotels in your advertising. 

* The best advice is to call or write the 
organizers of the other events. All have 
made mistakes at some point and should 
be able to offer some wisdom... better 
for you to learn from their mistakes 
rather than your own! 

* Finally, let me know! I will happily 
print any news of upcoming events and 
assist in any way possible. 
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RGB Color Display ... 

A Complete 64 Color Onscreen Chan for the CoCo 3 with RGB monitor 



Richard S.Bair 



When I purchased an RGB monitor for 
my CoCo 3 I felt that I had finally 
"arrived". 80 columns, and no herring- 
bone interference patterns across the 
screen! But two disappointments 
awaited: First, I discovered that lots of 
the Tandy software was now in boring 
black-and-white instead of delightful 
colors. Second, I couldn't make any 
sense out of the relationship between 
the 64 RGB colors and their numbers. 

The cause of the first problem has since 
been explained to me, and I am resigned 
toiL For the second, a solution came 
from the Tandy Service Manual for the 
CoCo 3, which explains how the differ- 
ent bits of the color number specify the 
strength of the red, green, and blue 
signals. I was pleased at the knowledge 
that there is a pattern to the colors, but 
this led me immediately to a challenge: 
Could a color chart be devised that 
would make the pattern obvious? 

Easier said than done. The TV/compos- 
ite color set is basically two dimen- 
sional, so it's easily displayed in an 
organized chart The RGB color set, on 
the other hand, is three-dimensional; a 
truly correct RGB color chart would 
resemble a 4x4x4 Rubik's cube with 
every little cube a different color, in- 
cluding ones buried inside! 

It is tempting to consider simply slic- 
ing the "RGB cube" into 4 layers which 
could then be 2-dimensional charts, 
but doing so obscures the logic of the 
colors; they are not in groups of 16 at 
all. Insofar as the cube has any symme- 
try, it is around an axis that runs from 
one corner (black,0) to the diagonally 
opposite corner (white,63). So the best 
2-dimensional reduction turns out to 
be an extraction from the cube of a 
series of "rings" of colors that circle 
the axis. 

RGBCLRDS displays the colors in 
three groups. The top group contains 
the three primary colors in their three 
available levels of brightness (plus 
black), and also all the colors created 



by mixing just two of the primaries in 
various proportions. I call these sec- 
ondary colors, though my dictionary 
says this is not the correct use of the 
phrase. Lower on the screen are the 
tertiary colors, which mix all three of 
the primaries in various proportions. 
At the bottom are the two "gray-scale" 
colors which lie on the axis of the 
"RGB cube" between black and white. 

Within each group, the colors are ar- 
ranged in order of brightness from left 
to right, and each vertical band repre- 
sents one of the "rings" mentioned 
above, cut midway between red and 
blue and flattened out If you study the 
display for a while, you will see that the 
progression of colors in each column 
leads from the bottom color to the one 
on top again. 

The BASIC program "RGBCLRDS" 
(RGB Color Display) first loads an ML 
program called "PALTJUGL" (Palette 
Juggle), then sets to work drawing the 
various color boxes on the screen. Most 
of this drawing is invisible, because all 
palette registers but one are set to the 
same color. Each color box is assigned 
a palette register number, but of course 
since there are 64 colors and only 16 
registers, they begin to repeat after a 
while. When the BASIC program fin- 
ishes drawing it turns control over to 
PALTJUGL, and the 64 colors appear. 
At this point you can have some fun 
playing with the brightness and con- 
trast controls to see how they affect the 
different colors. Several of the darker 
ones are totally black at low brightness 
levels. 

PALTJUGL accomplishes a 64 color 
display by continually changing the 
contents of the palette registers in synch 
with the display scan, so that each reg- 
ister contains the appropriate color at 
every point in the display. Even though 
nothing moves on the screen at this 
point, the CPU is busy! To exit the 
display, use CIRL-ALT-RESET, RE- 
SET, A simple RESET doesn't work. 
(Leaves the stack corrupted, I guess.) 



RGBCLRDS will work on cassette or 
RS floppy systems, but may not work 
right on a machine with any non-stan- 
dard ROM (ADOS users may want to 
disable ADOCS first), PALTJUGL is 
sensitive to the length of the IRQ rou- 
tine because palette accesses must oc- 
cur while the display trace is offscreen, 
otherwise streaks appear on the dis- 
play. The only change between cassette 
and disk versions is in line 30 of the 
BASIC program. "PUGLMKR" (Pal- 
ette Juggle Maker) creates PALTIUGL 
from DATA lines. If you plan to save 
them to cassette, record PALTJUGL 
immediately after RGBCLRDS on the 
tape. Have a colorful day! 



10 REM "RGBCLRDS" Color display 

for CoCo 3 RGB monitor 

15 (c) 1993 FARNA Systems PB, written 

by Steven S.Bair 

20 CLEAR 200, &H7EFF 

30 LOADM H PALTJUGL":REM For tope 

system change this step to CLOADM 

"PALTJUGL" 

40FORPR=0TOl5 

50 PALETTE PR,57 

60 NEXT PR 

70 PALETTE 1,1 

80HSCREEN2 

90 HPRINT(0,0),"The Color Computer 

RGB Monitor Color Set" 

100 HLINE(0,7)-(3 19,7),PSET 

110 HPRINT(6,l) t M <Darker 

Brighter^ 

120 HLINE(0,15)-(3 19,15),PSET 

130 HPRINT(14 f 21), M Please wait/' 

140 FOR C=0 TO 63 

150 READPIUa,Yl,X2,Y2 

160 HCOLOR PR,0 

170 HLINE(X1 ,Y1 )-(X2,Y2),PSET3F 

180 IF Xl>159 THEN HCOLOR 1.PR 

ELSE HCOLOR 0,PR 

190 IF Yl/8>INT(Yl/8) THEN LET 

Yl*Yl+4 

200LETY3=(Yl/8+INT((Y2-7)/8))/2 

210LETC$=STR$(C) 

220 IF LEN(C$)=2 THEN LET 

C$*"0 M +RIGHT$(C$,1)ELSELET 

C$=RIGHT$(C$ f 2) 

230HPRINT(Xl/8+l,Y3),C$ 

240NEXTC 

250 HCOLOR 1,0 

260 HPRINT(6 JX"Primary and Secondary 

Colors" 
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270HIINE(48,23)-(271,23),PSET 

280 HPRINT(12,13yTertiary Colors" 

290HLINE(96,111M215,111),PSET 

300 HLINE(1 12,168)- 

(207 f 175)JRESET3F 

310 HPRINT(4,21),"Black >> Gray 

>> White" 

320HUNE(32,175M287,175),PSET 

330 HPRINT(6.23)/To exit, press 

RESET button." 

340 EXEC 

350DATA2, 0, 24,31,183, 1,3Z 24, 63, 

47,14,32,48,63,71,10,64,40,95,51,13, 

32,72,63,95,12,64,88,95,99,10,64,64, 

95, 75, 3, 88, 176, 135, 183, 3, 64, 28, 95, 39, 

7,96.32,127,39,11.96.40,127,47,8,128, 

32,159,39,4,96,24,127,31.5.128,24. 

159,31,6,128,116.159.131 

360DATA7, 160, 120. 191. 127,5, 64,52, 

95,63,15,96,48,127,55,6,96,56,127,63, 

3,128,48,159,55,11,96,64,127,71,15, 

128, 132, 159, 147,7, 128,56, 159,63,3, 

160, 136, 191, 143, 12, 128,40, 159,47, 13, 

160,36,191,47,4,160,48,191,59.9.192, 

32,223,55, 12, 160, 128, 191, 135 

370DATA9, 192, 120,223, 127, 13, 192, 

128,223, 135, 14,224, 128,255, 135,5,64, 

76, 95, 87, 14. 96, 88, 127, 95, 15, 96, 72, 

127.79, 13, 128, 148. 159. 163,6,96.80, 

127,87,7, 128, 80, 159. 87,3, 128,72, 159, 

79, 14, 160, 152, 191, 159, 15, 128,88, 159. 

95,6,160,24,191,35,8,160,112,191,119 

380DATA10, 192, 112,223, 119, 11,160, 

84,191,95,9,192,80,223,103,9,192,152, 

223. 159,4.224, 112.255, 119, 12, 128 



,64.159,71,10.160,144,191,151,9,160, 

60,191,71,4,192,136,223,143,4,160,72, 

191,83,6,192,144,223,151,8,192,56, 

223,79,12,224,144,255,151 

390 DATA 4, 184, 176, 232, 183, 0, 224, 

120,255, 127,7,224, 136,255, 143, 11,256, 

124,287,139,11,224,152,255,159,3,256, 

108.287, 123,8,256, 140,287, 155,5,288, 

11Z319.183 



10 REM "PUGLMKR" PALTJUGL 
MAKER 

20 CLEAR 200.&H7EFF 

30 WIDTH 40 

40 FOR X=0 TO 14 

50T=0 

60 FOR Y=0 TO 15 

70 READ A$ 

80A=VALf&H M +A$) 

90 POKE &H7F0O+16*X+Y,A 

100T=T+A 

110 NEXT Y 

120 READ A$ 

130 IF VAL("&H"+A$>oT THEN 

GOTO400 

140 NEXT X 

150 PRINT "ML program is now in 

memory; to save totape, GOTO 200; to 

save to disk, GOTO 300." 

160 END 

200 CSAVEM 

M PALTJUGL M .&H7FOOAH7FEC&H7F0O 

210 END 



300 S AVEM "PALTJUGL", &H7F00, 

&H7FEC&H7F00 

310 END 

400 PRINT "ABORT: DATA ERROR 

INUNE";;PRINT lOOOf 10*X 

410 END 

1000 DATA 7F, FF, D8, 7F, 01, 13, B6, 

01,13,27,FB,CE,7F,61,86,FF,808 

1010 DATA D6, BC, CI, 0E, 27, 06, 12, 

12, 12, 12, 12, 12, 12, 12, 12, 12,342 

1020 DATA 12, 37, 04, 10. 8E, 00, 02, 31, 

3F, 26, FC, 5 A, 1 A, 00, 12, 12, 3 17 

1030 DATA 10, 8E, 00, 06, 31, 3F, 26, FC, 

5 A, 26, F5, 37, 04, F7. 7F, 60, 5BC 

1040 DATA 37 ,04 ,1F ,02 37 ,04 ,E7 ,A4, 

10, 8E, 00, 02, 31, 3F, 26, FC, 454 

1050 DATA 1 A, 00. 12, 7 A, 7F, 60, 26, 

E8, 1 1, 83, 7F, ED, 27, A5, 20, CI, 640 

1060 DATA 00, 02, 0E, B2, 00, B3, 08, 

B4, 0C, B5, 0D, B6, 29, B7, 09, B8, 556 

1070 DATA 0B, B9, IB, BA, 03, BB, 0A, 

BC, 18, BD, 19, BE, 02, BF, 1 1, 40, 5DB 
1080 DATA 06, B3, 13, B4, 1 A, B5, 10, 
B6,12,B7,16,B8,36,0C,0A,B9,5B1 
1090 DATA 32, BA, 06, BB, 14, BC, 30, 

BD, 04, BF, 22, B3, 26, B4. 34, B5, 6C5 
1100 DATA 20, B6, 24, 04, 04, B7, 25, B9, 
2D, BB, 2C, BC, 05, 04, 04, BE, 532 
1110 DATA 21, BF, 28, B3, 3D, B8, 2A, 
14, 0A, B A, 2B, B4, 2F, B5, 3F, B6, 66A 
1120 DATA 0E, B7, OF, B9, ID, BB. 3B, 
BC, 1C, BD, IE, BE, IF, 10, 0A, BF, 609 
1130 DATA 15, B3, 17, B4, 33, B7, 3 A, 
B8.3E,BA,31,B6,35,BC,37,BD,733 
1140 DATA 23, BE. 27, 04, 04, B9, 2E, 
BB, 3C, B3, 07, B4, 38, 00, 00, 00, 494 



The aspect ratio is off, but this is a 

good representation of the display 

"RGBCLRDS" generates. It is 

much better in full color! 



*NOTE: The assembly code listing 
for PALTJUGL is on "microdisk" 



TheCblarCon^^ 



<Darkcr 



Brighter> 



00 



01 



02 



04 



Primary and Secondary Colors 



08 



03 



16 



06 



32 



05 



12 



09 



10 



17 



18 



20 



34 



36 



21 



13 



11 



24 



19 



22 



48 



38 



37 



AIL 



41 



25 



26 



50 



52 



41 



27 



54 



45 



Tertiary Colors 



14 



21 



35 



42 



15 



28 



23 



49 



39 



43 



29 

lor 



51 



53 



"46 



47 



57 



31 



58 



55 



60 



61 



59 



62 



Black 



> > 



Gray 



> > 



White 



07 



156 



To exit, press RESET button. 



63 
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Little Black Book 



Jason Reighard 



A versatile address, telephone number, and mailing label database. 

Little Black Book (LBB) is a program 
to conveniently store addresses and 
phone numbers. You can use it to 
print mailing lists, mailing labels, 
and phone number lists. It is com- 
pletely menu driven and easy to 
use. LBB will run on any Disk Ex- 
tended BASIC Coco with at least 
32K. The program checks for the 
presence of a Coco 3 and will take 
advantage of some of it's features, 
but will run unchanged on any CoCo. 

The program automaticly sets your 
disk drives to run at 6 ms. If you get 
an IfO error, simply go to the drive 
options and select a slower rate. 
LBB also has an alphabetizing fea- 
ture that comes in very handy.The 
entire database is stored in memory 
to make sorting and searching light- 
ning fast. If the memory limit is 
reached, simply save your existing 
data as a file and start another. 
There is no limit to the number of 
files except disk space. 

Note that line 25 reads "PORTIONS 
BY L.TODD KNUDSEN". Mr. 
Knudsen contributed the code for 
error free double speed disk access 
(lines 80-140). As long as line 25 is 
included, the code may be used in 
any program. This information was 
originally published in the Glenside 
CoCo Club newsletter (CoCo 123). 

If there are any questions or sugges- 
tions, the author can be contacted 
at: 441 Ridgeland Dr., Toronto, Ohio 
43964-2022; phone (614)-537-4875. 
Please include a SA.S£ if request- 
ing a reply. Upgrades and modifica- 
tions should be sent to the publisher 
for future article considerations. 
Anyone care to convert this pro- 
gram to Basic-09? 



Jason will be a Senior at Edison High 
School (94-95 school year) and has used 
a Coco since second grade. He also likes 
electronics and ham radio. 



10 ' LITTLE BLACK BOOK, BY JASON 
REIGHARD, 1992,1993 
20 ' COPYRIGHT 1993, FARNA SYS- 
TEMS 

25 * PORTIONS BY L.TODD KNUDSEN 
30 CLEAR 3000:DIMN$(300), T$(300), 
A$(300), S$(300) 

40 IF PEEK(33021 )=50 THEN WIDTH32 
ELSE 70 

50 POKE 65497.0 
60 ON ERR GOTO2200 
65 4 CHECK FOR ADOS/EADOS 
70 IF PEEK(&HA282)=23 THEN 180 
'ADOS OR EADOS PRESENT 
75 4 DOUBLE SPEED FOR DISK 
DRIVES 

80 IF PEEK(&HC004)=214 THEN A$= M C 
0EED52AD6D1D6F1D727D75E M ELSE 
A$="C101D617D7C4D7E4D 81 AD 851* 
*214=DECB 1.0, 215=1.1 
90 FOR V=1T024 STEP 4 
100A=VALC&H M 4MID$(A$,V t 4)) 
110 POKE A,189:POKE A+1.240.POKE 
A+2,157:POKE A+3,18 
120 NEXT 

130 POKE &HF09D,52:POKE 
&HF09E,127 

140 POKE &HF09F,53:POKE 
&HF0A0.255 

150 IFPEEK(&HC004)=215rHEN170 
160 POKE&HD6CD,0: 

POKE&HD723,20: GOTO180 
170 POKE&HD7C0,0:POKE&HD816,20 
175 ' BEGIN PROGRAM 
180 DN=PEEK(235):N=0:CLS:PRINT" 
LTITLEBLACKBOOK 1.1" 
190 PRINT'COPYRIGHT 1992,93 
FARNASYSTEMS" 

200PRINT:PRINT" PRESS ANYKEY" 
210 Z$="b":GOSUB 2130 
220 Z$="bl":GOSUB 2130 
230 Z$="bla":GOSUB 2130 
240 Z$="blac":GOSUB 2130 
250 Z$="black M :GOSUB2130 
260 Z$="blacK":GOSUB2130 
270 Z$="blaCK":GOSUB2130 
280 Z$="blACK":GOSUB2130 
290 ZS="bLACK":GOSUB2130 
300 Z$="BLACK":GOSUB2130 
310 GOTO210 
320 • LOAD 

330 CLS: PRINTLOAD": PRINT@17 , 
"DEFAULT DRIVE" DN: PRINT "UTTLE 
BLACK BOOK FILES DRIVE" DN: 
GOSUB3130: LINEINPUTTILENAME> M ; 
F$: IF F$="THEN 440 ELSE IF PEEK 
(33021) =50 THEN 360 ELSE340 
340 IFLEN(F$>8 THEN ER=31: GOTO 



2200 ELSE FORX=lT08: IF MIDS 
(F$Xl)*TORMD>$(F$XlK-"THEN 
ER=31 :GOTO2200 
350 GOSUB3020:IF OD=0 THEN ER=26: 
GOTO2200 

360 OPENT\#l,F$+"/LBB M 
370 N=N+1 

380INPUT#1,N$(N),T$(N), A$(N), S$(N) 
390 IF EOF(l)=-l THEN 420 
400 N=N+1 
410 GOTO380 
420 CLOSE#l 
430'MAINMENU 
440 CLS 

450 PRINT'*MENU*": PRINT® 17, "DE- 
FAULT DRIVE" DN 
460 PRINT1 VIEW ENTRIES" 
470 PRINT2 EDIT ENTRIES" 
480 PRINT'3 PRINT" 
490 PRINT"4 LOAD" 
500 PRINT'S SAVE" 
510 PRINT6 DISK OPTIONS" 
520 PRINT7 ERASE ALL ENTRIES" 
530PRINT8 ALPHABETIZE" 
540PRINT9END" 
550 INPUT"SELECT1-9 M ;M$ 
560M=VAL(M$) 
570 IFM<10RM>9THEN440 
580 ON M GOSUB 610, 1010, 1470, 330, 
2030, 2340, 2650, 2680, 2300 
590 GOTO440 
600'VEEWMENU 

610CLS: PRINT f VIEW ENTRIES": PRINT 
620PRINT ,, 1 VIEW ALL ENTRIES" 
630 PRINT"2 SEARCH FOR A ENTRY" 
640PRINT3 RETURNTOMAINMENU" 
650 INPUT"SELECT(1-3)";M$ 
660M=VAL(M$) 
670 IFM<lORM>3THEN610 
680 ON M GOT0700,850,690 
690 RETURN 
700 FORX^ITON 
710 CLS 
720PRINTN$(X) 
730PRINTA$(X) 
740 PRINTS$(X) 
750PRINTT$(X) 
760 PRINT 

770 PRINT"PRESS ENTER TO 
CONnhOJE":PRINnPRESSXTOEXrr 
780A$=INKEY$ 
790 IFA$=CHR$(13)THEN 820 
800IFA$= M X*THEN610 
810 GOTO780 
820NEXTX 
830 GOTO610 
840 ■ SEARCH 
850 CLS:LINE INPUT"NAME TO 
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SEARCH FOR >» ";M$ 

860IFM$= MM THEN610 
870 Q=LEN(M$) 
880 FORX=lTON 

890 IF M$ = LEFT$(N$(X).Q) THEN 900 
ELSE 970 
900 CLS 
910PRINTN$(X) 
920PRINTA$(X) 
930 PRINTS$(X) 
940PRINTT$(X) 

950 PRINT:PRJMTTOT ANY KEY TO 
CONTINUE" 

960IFINKEY$=""THEN960 
970NEXTX 
980 CLS 

990 PRINT@0/'NarHING MORE UN- 
DER THAT ENTRY"; :PRINT@32, 
"PRESS ANY KEY";; A$=INKEY$: 
IFA$="*THEN 990 ELSE610 
1000 4 EDIT 

1010 CLS:DE$="":PRINT"EDIT EN- 
TRIES" 
1020 PRINT 

1030 PRINT'l CHANGE ENTRY'* 
1040 PRINT"2 ADD ENTRIES" 
1050 PRINT"3 DELETE ENTRY" 
1060PRINr'4RETURNTOMAINMENU 
1070 INPUT'SELECT(1-3)";M$ 
1080M=VAL(M$) 
1090 IFM<lORM>5THEN1010 
1100 ON M GOTO1130,1350,l 190,11 10 
1110 RETURN 
1120 'CHANGE 
1130 CLS 

1140 IA$=" CHANGE": AA$=" 

CHANGE": A$=" CHANGE": GOSUB 
2810 

1150 IFZ$=' WTHEN 1010 
1160 IF DE$="N"THEN1010 
1170 IFM$='"THEN 1010 
1180 GOTO1260 

1 190 IA$=" DELETE": A$="ENTER 
NAME YOU WISH TO DELETE": AA$=" 
DELETE":GOSUB2810 
1200 IFDE$="N" THEN1010 
1210 IFZ$="N-THEN1010 
1220 IFM$=""TBEN 1010 
1230 INPUT-ARE YOU SURE(Y/N)??"; 
M$: IFM$="Y-THEN1240ELSE1010 
1240N=N-1:FORXX=XTON:N$(XX)==N$ 
(XX+1):T$(XX)=T$(XX+1): A$(XX)=A$ 
(XX+1): S$(XX)=S$(XX+1 ): NEXTXX 
1250 GOTO1010 
1260M=X:CLS 

1270 PRINTN$(M): PRINTT$(M): PRINT 
A$(M): PRINTS$(M): PRINT STRINGS 
C3Z"*"); 

1280 PRINTTRESS [ENTER] FOR NO 
CHANGE" 

1290 LINEINPUT"NAME >» ";M$: 
IFMSo ,w, THENN$(M)=M$ 
1300 LINEINPUT'NUMBER >» 



"J4$JFM$o ,w THENT$(M>=M$ 

1310 UNEINPUT'ADDRESS >» ";M$: 

EFM$o m THENA$(M)=M$ 

1320 UNEINPUT "CITY, STATE, ZIP 

CODE >» M W$: IF M$o"" THEN S$ 

(M)=M$ 

1330 GOTO1010 

1340 * ADD RECORDS 

1350 CLS:PRINT"ADD RECORDS" 

1360 N=N+1:PRINT"REC."N 

1370 IF N>300 THEN 2640 

1380 PRINTTYPE **END' WHEN YOU 

DO NOT WISH TO ENTER ANY MORE 

RECORDS" 

1390UNEINPUr'NAME>»"Ji$(N) 

1400IFN$(NX'*END'THENN=N-1:RE- 

TURN 

1410UNEINPUT'MJMBER>>>";T$(N) 

1420 LINEINPUT"ADDRESS >» 

";A$(N) 

1430 uneinput'OTy, state, zip 

CODE »";S$(N) 

1440 IF N>=300THENN=300:RETURN 
1450 GOTO1350 
1460 'PRINT ENTRIES 
1470 CLS:PRINTTRINT' 
1480 PRINT:PRINT'l PRINT ALL EN- 
TRIES": PRINT2 PRINT SINGLE EN- 
TRY": PRINT3CHANGEBAUDRATE": 
PRINT'4RETURNTOMAINMENU" 
1490 UNEINPUT "SELECT 1-3 ";A$ 
1500A^VAL(A$) 
1510 IFA<10RA>5 THEN1470 
1520 ON A GOTOl540,1710,1900,440 
1530 GOTO1470 

1540CLS:PRINrTRINTALLENTRIES": 
PRINT 

1550PRINT f OP r nONS' l :PRINT'l PRINT 
NAME. ADDRESS AND NUMBER";: 
PRINT 7 PRINT NAME AND NUMBER 
ONLY":PRINr3PRINTNAME AND AD- 
DRESS ONLY": PRINT'4 ABORT' 
1560 UNEINPUT'SELECT 1-4 ";Z$ 
1570 IFZ$="4 M THEN 1470 
1580Z=VAL(Z$) 
1590 IF Z>4 THEN1540 
1600 IF Z<1 THEN1540 
1610 UNEINPUTHOW MANY LINES 
TO SKIP BETWEEN LABELS ";LL$: 
UNEINPUT , MARGIN*y4M$:MM=VAL 
(MM$) 

1620 IF LU^THEN 1470 
1630LL=VAL(LLS) 
1640 CLS0 
1650 FORX=lTO N 
1660PRINT#-ZTAB(MM);N$(X) 
1670 IFZ=10RZ=3 THEN PRINT#- 
ZTAB(MM);A$(X) 

1680 IFZ=10RZ=3 THEN PRINT#- 
ZTAB(MM);S$(X) 

1690 IFZ=10RZ=2 THEN PRINT#- 
ZTAB(MM);T$(X) 
1700 FOR Q=lTO LL:PRINT#-2: 



NEXTQ: NEXTX: GOTO1470 
1710CLS: IA$="PRINT': AA$="PRINT': 
GOSUB 2810 
1720 IFZ$="N'THEN1470 
1730 IFDE$=*TSTTHEN1470 
1740 IFM$=""THEN1470 
1750 CL^PRINT'OPTIONS'^PRINT"! 
PRINT NAME, ADDRESS AND NUM- 
BER";: PRINT7PRnSTTNAME ANDNUM- 
BER ONLY": PRINT3 PRINTNAME AND 
ADDRESS ONLT ': PRINT'4 ABORT' 
1760 LINEINPUT"SELECT 1-4 ";Z$: 
Z=VAL(Z$): IFZ=4 THEN 1470 ELSE 
UNEINPUT'MARGIN";MM$:MM=VAL 
(MM$) 

1770 IK$= M 4" THEN 1470 
1780 IF Z<1 THEN1750 
1790 IFZ>5 THEN1750 
1800CLS0:PRINT#-ZTAB(MM);N$(X) 
1810 IFZ=lORZ=3 THEN PRINT#-2, 
TAB(MM);A$(X):PRINT#-ZTAB (MM);S$ 
(X) 

1820 IFZ=20RZ=1 THEN PRINT#- 
ZTAB(MM);T$(X) 

1830 CLS:PRINTTRESS (SPACEBAR) 
TO ADVANCE PRINTER ONE LINE": 
PRINT "PRESS (ENTER) TO PRINT 
LABEL AGAIN": PRINTTRESS @ TO 
SELECT ANOTHER LABELTO PRINT': 
PRINTTRESS M FOR MENU" 
1840A$=INKEY$ 

1850 IFA$=" "THEN PRINT#-2: GOTO 
1830 

1860 IFA$=CHR$(13)THEN 1750 
1870 IFA$="@" THEN 1710 
1 880 FA$="M" THEN 1470 
1890 GOTO1840 

1900 CLS:PRINT"CHANGE BAUD 
RATE" 

1910 PRINT:PRINT'l 600":PRINT"2 
1200 H :PRINT"3 2400 M :PRINT"4 

4800*':PRINT'5 9600 M :PRINT"6 NO 
CHANGE" 

1920 UNEINPUT "SELECT 1-8 ";A$ 
1930 IFA$="1 M THEN X=l 80:GOTO2000 
1940 IFA$="2 M THEN X=87:GOTO2000 
1950 IFA$="3" THEN X=41:GOTO2000 
1960 IFAfc="4 M THEN X-18:GOTO2000 
1970 IFA$="5" THEN X=4:GOTO2000 
1980 IFA$="6 M THEN 1470 
1990 GOTO1900 
2000 POKE 150.X 
2010 GOTO1470 
2020 ' SAVE 

2030 CLS: PRINT'S AVE": PRINT® 17, 
"DEFAULT DRIVE'TJN: UNEINPUT 
"SAVE FILENAME»";F$:IFF$=:* ,tr rHEN 
440 ELSE IF PEEK(33021)=50 THEN 
2050 ELSE2040 

2040 IF LEN(F$)>8 THEN ER=3l : 
GOTO 2200 ELSE NEXTX: RETURN 
2050 GOSUB3020:IF OD=l THEN 
PRINT "file already exists": PRINT 
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'•OVERWRITE (Y/N)" ELSE 2080 
2060 A$=INKEY$:IFA$="Y"THEN 2080 
ELSE IF A$="N" THEN 440 
2070 GOTO 2060 
2080 OPEN"0'\#l,F$+".LBB" 
2090 F0RX=1T0N 

2100WRTTE#l f N$(X) t T$(X),A$(X),S$(X) 
2110 NEXTX:CLOSE#l 
2120 GOTO440 
2130 FORX=lTO20 
2140A$=INKEY$ 
2150 PRINT® 132$; 
2160 IFA$="" THEN NEXTX:RETURN 
2170 GOTO440 
2180LL=VAL(LL$) 
2190 ' ERROR MESSAGES 
2200 CLS:PRINTTHE FOLLOWING 
ERROR HAS OCCURED": PRINT: 
SOUNDU 

2210 IF ERNO=30 THEN PRINTTHIS 
DISK IS WRITE PROTECTED": 
PRINT'CHECK DISK": GOTO2270 
2220 IF ERNO=20 THEN PRINTT/O 
ERROR":PRINT'CHECKDISKDRIVE": 
GOTO2270 

2230 IF ERNO=31 THEN PRINTBAD 
FILENAME":PRINTTOUR FILENAME 
CANNOT BE MORE THAN EIGHT 
CHARACTERS LONG AND CANNOT 
CONTAIN A . OR A / ":GOTO2270 
2240 IF ERNO=26 THEN PRINTTILE 
NOT FOUND":GOTO2270 
2250 IF ERNO=28 THEN PRINTDISK 
FULL ":GOTO2270 

2260 IFERNO=6 THEN PRINTOUT OF 
MEMORY ERROR":GOTO2270 ELSE 
PRINTTATALERROR #"ERNO" 

INIINE"ERIIN" 

2270 PRINT:PRINTTRESS ANY KEY 
FOR MENU" 

2280 A$=INKEY$: PRINT® 14, "ER- 
ROR";: IFA$="" THEN2290 ELSE 440 
2290 A$=INKEY$: PRINT@14, "error";: 
IF A$='"' THEN2280 ELSE 440 
2300 SOUND100.10: CLS: UNEINPUT 
"AREYOUSUREYOUWANTTOQUTT? 
(Y/NT;A$ 

2310 IFA$="Y"THEN POKE65496.0: 
POKE65495.0: END 
2320 GOTO440 
2330 'DISK OPTIONS 
2340 CLS:PRINT@0: , DISK OPTIONS": 
PRINT@32," 1 CHANGE DEFAULT 
DRIVE" 

2350 PRINT' 2 CHANGE STEP RATE" 
2360 PRINT* 3 RETURN TO MENU" 
2370 INPUT D 

2380 IF D <1 OR D>3 THEN 2340 
2390 IF D=l THEN 2420 
2400 IF D=2 THEN 2490 
2410 IF D=3 THEN 440 
2420 PRINT® 17,"DEFAULT DRIVE" 
DN;: PRINT'CHANGE DEFAULT 



DRIVE": PRINT:PRINT"SELECT 0- 

3":PRINT"PRESS [ENTER] FOR NO 

CHANGE":PRINT:PRINT"CURRENT 

DRIVE NUMBER "DN: PRINT: PRINT: 

PRINT: PRINT 

2430A$=INKEY$:IFA$=" , THEN2420 

2440 IF A$=CHR$(13) THEN 440 

2450 IF V AL( A$)>5 THEN 2420 

2460DN=VAL(A$) 

2470 IF DN>3 THEN 2420 

2480 DRIVE DN:GOTO440 

2490 CLS: PRINT@32,"SELECT STEP 

RATE" 

2500 PRINT' 1 = 6ms 2 = 12ms" 

2510 PRINT' 3 = 20ms 4 = 30ms" 

2520 PRINT:INPUT f Selected Value";D$ 

2530IFPEEK(&HC004)=215 THEN 2540 

ELSE 2580 

2540 IFD$="1THENPOKE&HD7CO,0 

POKE&HD8 16,20: GOTO440 

2550 IFD$="2 M THENPOKE&HD7C0 > 0: 

POKE&HD8 1 6,2 1 :GOTO440 

2560 IFD$="3THENPOKE&HD7C0,0: 

POKE&HD8 16,22:GOTO440 

2570 IFD$="4 t THENPOKE&HD7C0,0: 

POKE&HD8 16,23:GOTO440 

2580 BFD$="1THENPOKE&HD6CD,0: 

POKE&HD723,20:GOTO440 

2590 IFD$="2THENPOKE&HD6CD,0: 

POKE&HD723,21:GOTO440 

2600 IFD$="3THENPOKE&HD6CD,0: 

POKE&HD723,22:GOTO440 

2610 IFD$="4 M THENPOKE&HD6CD,0: 

POKE&HD723,23:GOTO440 

2620 GOTO 2490 

2630 'FULL 

2640 CLSiPRINT-RECORDSFULL !!!!": 

N=300: SOUND100.10: GOTO 440 

2650 SOUND100,10: PRINT'ARE YOU 

SURE??? (Y/N)";:INPUTA$:IFA$="Y" 

THEN 2660 ELSE 440 

2660 Q$="":FORX=lTON:N$(X)=Q$: 

T$(X>=Q$:A$(X> S Q$:S$(X>=Q$:NEXTX: 

N=K): GOTO440 

2670 4 SELECTION SORT 

2680 CLS0 

2690 FOR Z= N TO 1 STEP -1 

2700MX$ = N$(1):MX = 1 

2710 FOR ZZ = 1 TO Z 

2720 IF N$(ZZ) > MXS THEN MXS=N$ 

(ZZ):MX=ZZ 

2730 NEXT ZZ 

2740TM$=N$(Z): N$(Z)=MX$: N$(MX)= 

IMS 

2750TM$=T$(Z):TS(Z)=T$(MX):T$(MX) 

=TM$ 

2760TM$=A$©: A$(Z)=A$(MX): A$(MX) 

=TM$ 

2770TM$=S$(Z): S$(Z)=S$(MX): S$(MX) 

=TM$ 

2780 NEXT Z 

2790 RETURN 

2800 * LOCATE ROUTINE 



2810 CLS:PRINr"ENTER THE NAME 
YOUWISHTO'TA$;:UNEINPUr , »>"; 
MS 

2820 IF M$='"THEN RETURN 
2830 Q=LEN(M$) 
2840 FORX-1TON 

2850 IF M$ = LEFT$(N$(X),Q) THEN 
2860 ELSE 2960 
2860 CLS 
2870 PRINTN$(X) 
2880PRINTA$(X) 
2890 PRINTS$(X) 
2900 PRINTT$(X) 

2910 PRINT:PRINTTS THIS THE EN- 
TRY YOU WISH TO "AA$"(Y/N)r 
2920Z$=INKEY$ 
2930 IFZ$="Y'THEN RETURN 
2940 IFZ$="N-THEN 2960 
2950 GOTO2920 
2960NEXTX 
2970 DE$="N" 
2980 CLS 

2990 PRINT@0,"NOTHING MORE UN- 
DER THAT ENTRY";: PRINT@32, 
'TRESS ANYKEY";:A$=INKEY$:IFA$= 
""THEN 2990 ELSE RETURN 
3000 POKE 65496,0 
3010 'FILE LOCATE 
3020 OD=0:SG=3:F1$=F$ 
3030 IF LEN(F1$)<8 THEN FORX=l TO 
(8-LEN(Fl$)):Fl$=Fl$+" ":NEXTX 
3040 F1S=F1$+"LBB" 
3050 DSKIS DN,17,SC.A$,B$ 
3060 IFA$=STRING$(128 t 255) THEN 
3120 

3070 PS=1 

3080 IFMID$(A$ f PS,ll)=:Fl$ OR MID$ 
(B$,PS,11)=F1$ THEN OD=l: GOTO 
3120 

3090 PS=PS+32:IF NOT(PS>128) THEN 
3080 

3100 SC=SC+1: IF SC>11 THEN 3120 
3110 GOTO 3050 
3120 RETURN 
3130 FORSC=3TOH 
3140 DSKIS DN,17,SC,A$,B$ 
3150 IFA$=STRING$(128J55) THEN 
3210 

3160 FOR PS=1T097STEP32 
3170 IFMID$(A$,PS-^,3)="LBB" THEN 

PRINT MTO$(A$4>S f 8) 

3180 IFMID$(B$,PS+83)="LBB'THEN 

PRINTMID$(B$.PS,8) 

3190 NEXTPS 

3200 NEXTSC 

3210 RETURN 



EDITORS NOTE: This program was 
formerly sold by FARNA Systems 
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The Hardware Hacker 

Not just questions and answers, but complete hardware guidance, 



Dr. Marty Goodman 



A Floppy Disk Drive Tutorial 

Terry Simons, publisher of the disk- 
based Color Computer newsletter UP- 
GRADE (Mid Iowa & Country CoCo 
Club), asked me about some problems 
he was having writing to diskettes he 
had bought. Seems his drives appeared 
to write to and verify the information, 
but when he sent them to other people, 
a number of them reported they could 
not read the diskettes. My first thought 
was that the drives writing the diskettes 
were out of allignment Terry checked 
his drives with a J&M disk drive 
allignment checker program ("Memory 
Minder") and found them to be in gen- 
erally good allignment. There seemed 
to be more people having problems 
than would be expalined by the occa- 
sional end user with badly alligned 
drives. 

It turned out that Terry purchased dis- 
kettes that were designed for use with a 
1.2 megabyte "AT style" 5.25 in drive. 
That explained the unreliable writes to 
the diskettes, because such diskettes 
have differnt magnetic media (with 
twice the magnetic coercivity) from 
disks used for 360K drives. 

In the course of our discussion, Terry 
and I had trouble with terminology, 
because words used to describe the 
differing diskettes and disk drives tend 
to be very ambiguous. So here are some 
clarifying comments I offerred to Terry 
regarding 5.25 in drives: 

Most color computer users employ 
one or another varient of what is 
bascially the same sort of disk drive. 
This is the 35 track single sided, 40 
track single sided, or 40 track double 
sided 5.25 in drive. The single sided 
drives were sold by Tandy up until their 
last drive system, the FD502. All Tandy 
drives were 40 track except for the very 
first drive system they sold, which could 
only write 35 tracks. Many CoCo users 
today have double sided drives. Double 
sided 525 in 40 track drives were the 



standard for years in the world of the 
IBM PC, too. Such drives, sometimes 
called "double density" drives, could 
put 360K of data on a diskette after 
formatting. The 35 and 40 track single 
and double sided drives all use the same 
type of diskette. This diskette is a 5.25 
in "double density" diskette that has 
magnetic media with a coercivity of 
300 oersteds. The defining character- 
istics of these drives is that they use 
magnetic media (diskettes) that have a 
magnetic coercivity of 300 oersteds, 
and that they read and write data at a rate 
of250Kbaud. 

Some OS9 users and some ADOS us- 
ers have been using 5.25 in drives that 
can write 80 tracks, and put a total of 
720K of formatted data space on a 
double sided disk. These 80 track, 720K 
drives are rather unusual in the greater 
world of computing. The Tandy 2000 
used them, as did a few other ancient, 
obsolete MS DOS engines, and a num- 
ber of CPM computers used this type 
of drive, too. These drives, very con- 
fusingly called at one time "quad den- 
sity drives", use the SAME type of dis- 
kette as those used by the 360K drives. 
Their data transferrate is, like the 360K 
drives, 250K baud. They have the same 
number of sectors available on a given 
track. They differ only in that the tracks 
are half the width, so there can be 80 
tracks on a side, instead of 40. To read 
a 35 or 40 track disk, the head is "double 
stepped", or moved two tracks at once. 
TTie same rule should be observed when 
writing as between 360K and 1.2 meg 
disks: only write to a disk formatted in 
the writing drive. OS-9 provides for 
double stepping the drives. Disk BA- 
SIC users would have to add a circuit to 
allow double stepping (see June 1989 
Rainbow, page 98). 

When IBM introduced the PC AT, they 
supplied with with, as its "standard" 
drive,a5.25 in drive that hadatotal data 
capacity of 1 .2 megabytes. This drive is 
best referred to as a " 1 .2 meg" drive, or 
as a "AT style 525 inch" drive. This type 



of drive was patterned after the last 
generation of 8 inch disk drives, for 
both it and its 8 inch predecessors had 
80 tracks which each had on them capa- 
bility to hold 15 512 byte long sectors 
per track. 

The "AT style" drive has a data transfer 
rate of 500K baud, twice that of the 
360K and 720K drives. It uses DIF- 
FERENT diskettes. These disks are to- 
day commonly (and very confusingly) 
called "high density" 5.25 in diskettes. 
One would better refer to them as " 12 
meg" diskettes, for sake of clarity. 
These " 1.2 meg" disks have a magnetic 
coercivity of 600 oersteds. This means 
that it takes MORE magnetism to 
magentize them than with a 300 oer- 
sted disk. "AT style" 5.25 inch disks 
will NOT work reliably in a 35 or 40 
track single or double sided drive of the 
sort used by most CoCo owners. 

On PC compatibles, one can format a 
totally blank, unformatted 1*2 meg dis- 
kette in a fashion that puts only 360K 
of data on it, and that allows it to be read 
by most 5.25 inch 360K drives. Simi- 
larly, a 1.2 meg disk drive can be used 
to READ 360K type diskettes. Prob- 
lems arise when one trys to WRITE to 
a 360K disk that was formatted on or 
written to by a 360K drive, using a 1 .2 
meg drive. The general rule is to format 
and write the disk with the same type 
drive and no other. 

99% of CoCo systems that use a Radio 
Shack floppy disk controller or one of 
the third party clones of same (J&M, 
Disto, HDS, etc.) cannot use 12 meg 
5.25 in drives (and cannot use 1.4 meg 
3.5 in drives) because such controllers 
are inacapable of supporting the 500K 
baud data rate required by such drives. 
Such ordinary CoCo systems CAN use 
360K 40 track 525 inch drives, and can 
also use 720K 80 track 5.25 and 3.5 
inch drives. 

(Editor: The oldest Tandy 12V con- 
troller can be modified for 12 meg 
drive support... watch for an article!) 
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Terry's problem was that he was trying 
to format 1.2 meg diskettes in a 360K 
drive. The improper magnetic coerciv- 
ity of those diskettes resulted in unre- 
liable formating and writing. 

Some other comments: 1 .2 meg drives 
normally rotate at a different speed 
from 360K drives. They usually are set 
up to rotate at 360 rpm, instead of the 
300 rpm standard for 360K drives. The 
12 meg drives normally rotate at 360 
rpm both when they are writing 1 2 meg 
diskettes AND when they are being 
used to write a pseudo 360K diskette. 
However, most brands of 1 2 meg drives 
have the CAPABILITY to rotate at 300 
rpm. One must jumper them into a "dual 
speed mode" to permit this. Specific 
information about a given individual 
model of drive is needed to find the 
correct jumper settings. There are some 
files on Delphi that give such informa- 
tion, and one file that specifically de- 
tails jumper settings for a 1.2 meg 
TEAC drive. Perhaps I'll give those 
details in this column if enough re- 
quests are made (these files are on this 
month's "microdisk"). 

There are many other more obscure 
disk drive types that I did not discuss 
here. These include the 80 track 5.25 in 
360K single sided drive, the Amdek 
3.0 in drives, and a number of 325 in 
drives. Note that Apple and Commo- 
dore drives CANNOT be used with a 
CoCo, for they have totally different 
logic boards and interfaces. 



Disk Drive Summary: 



Diskette 








Magnetic 






Capacity 


XferRate 


Diam 


Coeicivity 


CoCo 




Tracks Sides 


Kbytes 


Kbaud 


inches 


Oersteds 


Compat 


NOTES 


35 1 


157.5 


250 


5.25 


300 


Y 


1 


40 1 


180 


250 


5.25 


300 


Y 


2 


40 2 


360 


250 


5.25 


300 


Y 


3 


80 2 


720 


250 


5.25 


300 


Y 


4 


80 2 


1200 


500 


5.25 


600 


N 


5 


80 2 


720 


250 


3.5 


600 


Y 


6 


80 2 


1406 


500 


3.5 


700 


see note 7 



Notes: 

1 ) ancient, original CoCo disk drive supplied by Tandy- Disk Basic was designed to support 
this obsolete 35 track drive, and was never altered by Tandy. ADOS and ADOS 3, of course, 
permit full use of 1 80K, 360K, and 720K disk drives under Radio Shack disk basic. 

2) disk drive suppliedby Tandy in all CoCo drive systems after the first, gray cased full height 
drive, with the exception of the last system released, the FD502 system. 

3) original "standard" disk drive for ancient M PC Compatibles". Now considered obsolete 
in world of PC compatibles, and considered the standard for CoCos. 

4) this is an odd-ball 5.25 in drive, used in the Tandy 2000 and some CPM computers. It 
is electrically identical to 720K 3 J in drives. It has found favor with CoCo OS9 users. 

5) this is the "AT style" disk drive, supplied with the original IBM PC AT. It is gradually 
becoming obsolete in the world of the PC, as 3 5 in 1 .4 meg diskettes and drives take over as 
the currentstandard in the worldof the PC, with 2.8 meg disk drives and20meg floptical drives 
waiting in the wings. 

6) this drive has become popular with current CoCo OS9 users, for it is plentiful and cheap 
and compatible with existing CoCo disk controllers. 

7) this is the current "standard" in PC compatible drives. It is commonly (and quite wrongly) 
referred to as a "1 .44 meg" drive. In fact, its data capacity is actually 1 .40625 megabytes, and 
so it is most accurately referred to as a "1.4" megabyte drive. The error was made when 
slipshod promoters decided to re-define a megabyte as 1 000 kilobytes (a "megabyte" is 1024 
kilobytes). This drive cannot be used as a 1.4 meg drive with a CoCo disk controller, but CAN 
happily be made to function as a 720K drive. 



Other Items of Interest 

I recently succeeded in converting a 
Puppo Keyboard Interface designed 
to work only with an Eagle keyboard 
into one that would work with a PC XT 
keyboard. The conversion primarily 
consisted of making a copy of the ROM 
from a Puppo XT keyboard interface 
and substituting that ROM for the one 
used in a Puppo Eagle keyboard inter- 
face. One might also want to try adding 
a 470 pfd capacitor between pin 1 of 
the keyboard conector and ground, and 
pin 2 of the keyboard connector and 
ground. 



Alain Pilon asked me about getting a 
Mouse for his CoCo. He wanted to buy 
a PC compatible mouse, and then re- 
wire it for the CoCo. I explained to him 
that mice for the CoCo were electroni- 
cally unique (they work identically as a 
joystick), and that IBM PC type mice 
simply cannot be made to work via the 
joystickportonaCoCo.Hewouldhave 
to find a used CoCo mouse. Drivers are 
available that allow use of a serial PC 
type mouse under OS-9, and at least 
one software package under DECB 
(Diecom's "TheRat" graphics program). 



Questions for this column may be ad- 
dressed to the magazine or directly to 
Dr. Goodman at 1633 Bayo Vista Ave., 
San Pablo, CA 94806; or Delphi E- 
mail to MARTYGOODMAN. Internet 
users may also send E-mail to 
martygoodman@delphi.com. Please, 
do not expect a personal reply. 



Dr. Marty Goodman, MJ). t is an 
anesthesiologist, long time CoCo 
advocate, and electronics tinkerer. 

He has been writing about the 

CoCo continuously since 1986. We 

are proud to have him continue that 

legacy in these pages! 
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Beginning With OS-9 

Time to take the shrink wrap off that box and start learning! 



Rick Ulland 



Before we plunge head first into our CoCos, 
allow me to drag out my soapbox for just a 
minute. Many users of OS-9 will say, in all 
seriousness, that youMUST ins tall this or that 
patch or do some hardware modification to 
your CoCo before 4 really * using OS-9 These 
same people will inform you, in the same 
serious tones, that most of the utilities onyour 
Tandy disks are absolute garbage and must 
immediately be replaced. HOGWASH! It is 
true that after installing the 30 odd patches 
available for Level 2, it is a much more 
capable system than stock- in the same fash- 
ion that a bored and blueprinted 350 Chevy 
with twin cares and ahot cam is more capable 
than Mom's Caprice Classic. And while the 
'six way power seat* commercial utility pro- 
grams are nice, there is certainly nothing 
wrong with pulling the lever and scooting 
forward. We will be getting into all of that 
here, but for now lets just get the Caprice to 
the handy mart! I know kzgen will make a 
bootfile a tad faster and you really have to 
strap the MPI to run 3 serial ports! !! That's it 
for the sermon. On to business. 

Tandy, in their infinite wisdom, decided to ship 
OS -9 set up in its least capable configuration. 
A single 32 column all cap screen and 35 track 
single sided drives greet the new user with 
open arms! The joy a he feels when first 
viewing this screen is hard to imagine. There 
is a good side to this, however. It has to be 
changed right away so we can explore the 
possibilities. Most operating systems are a 
singleprogram, designed to operate onesingle 
computer one single way. DECB runs a 
CoCo this way. MSDOS runs an IBM or 
'clone* that way. If you don't like it, tough. 
Buy a program that includes it's own substi- 
tute for the resident DOS if you can afford it 
But OS-9 isn't a monolithic whole- it's a 
collection of pieces. Technically, there is no 
single program 'CoCo OS-9'. Tandy (and 
other makers of OS-9 machines) took the 
generic 'OS -9 collection', added some CoCo 
specific modules, and wrote a manual. Viola! 
CoCoOS-9! 

There are some big advantages to this sys- 
tem. First, you can make as big or as small an 
Operating System as you need. A 128K 
single floppy machine can 't afford to have big 
chunks of hard drive code sitting uselessly in 
RAM, while the power user might notbe able 
to live without his serial mouse or other 
special purpose driver. When a 'hacker' wants 
to improve some aspect of the system, he only 
has to deal with one small module, not hun- 



dreds of kilobytes of code. And last, who 
cares what the maker THOUGHT they were 
selling- make what you want out of it 

TheMODULES directory on theBASIC09/ 
Config disk includes apretty goodselectionof 
OS-9 modules. Each file there has an exten- 
sion which gives you some clue as to what it 
is. Tandy also supplied a booths tThis is just 
a list of the modules you want in your system. 
It helps to think of the bootlist as an outline. 
The stock Tandy bootlist reads: 

OS9P2 
Init 

IOMan 

RBFjnn (Random Block File manager, can 
handle any disk drive style file system) 
CC3Disk.dr (drives common coco floppy 
drive systems) 

D0_35s.dd (35 track single sided drive) 
Dl_35&dd (35 track single sided drive) 
DDdO 35<wdd (defaultdrive,35 track single 
sided drive dO) 

SCFjnn (Sequential Character File man- 
ager does the one character at a time things) 
CC3IO At (CoCo 'console' driver handles 
the vdgintio, keyboard, andvideo,using these) 
VDGInUo 

Grflntio (two IO files) 
Term vdg.dt (the 'main* screen- a 32x16 
VDG!) 

Tenn_wiiLdt (40/80 column window screen) 
W.dw (Generic window uses next available 
numbered window. Or call by number.) 
Wl.dw (Each window HAS to have a num- 
ber!) 

ACIAPak.dr (hardware serial port driver) 
T2-dd (describes Tandy RS232 pak/clone) 
PRINTER-dr (bit-banger printer driver) 
P.dd (bit-banger printer descriptor) 
PipeMamnn (manages communication be- 
tween process) 

Plpendr (driver for coco hardware) 
Pipcdd (and descriptor) 
Qock.60Hz (can'ttimeslice without aclock!) 
CC3Go ('launches' OS9 on coco3) 

Using the stock bootlist as an outline, andour 
notes, we can pick apart the stock list and 
make up our own personal wish list All it 
takes is a text editor! Lets run through the 
stock list section by section: 

KERN AL: There are 3 modules added au- 
tcinaticallylDyourboot(REL ( BootOS9Pl.- 
won't be in the bootlist) which form the heart 
of a basic OS-9 system. The two modules at 
the start ofbootlist are extensions of this basic 



set and should always be included. These five 
modules are collectively known as the kemal. 
This inner core only needs 2 external modules 
to form a 'real' OS-9 system. IOMan pro- 
vides the path from here to any of the manag- 
ers listed below, while clock is needed to time 
the multitasking. Now we get to the options. 

RBF: Almost a no-brainer. Anything that 
even resembles a disk drive goes through this 
manager, including floppies, hard drives, and 
ram disks. Undo: RBF the most common 
entry would be the CC3Disk driver and the 
floppy descriptors it needs to run your floppy 
drives- which are probably better than the35 
single 'standard'. Replace the stock descrip- 
tors with ones that reflect your floppies (an 
FD502 is really a 40trk, double sided drive; 
FD501 single40track).Harddisk owners will 
add the hard disk driver and descriptor set 
right after the floppy stuff. RAMdisks fit 
under this heading also- so the ramdisk driver 
and descriptor should be placed in this block 
of the bootlist. There is a special descriptor 
for RBF- the DD or default drive is simply a 
copy of one of the other RBF device descrip- 
tors, renamed as /dd. /dd insulates your 
system from your programs... the program 
doesn't have to know if you run floppies, a 
hard disk, ramdisk, or something that hasn't 
been invented yet., it's special files will be on 
Md! 

SCF: This is the hardest working manager on 
your coco! The first thing it is responsible for 
is the console (keyboard/video). Here you 
have 3 levels to choose from. Vdglnt is a very 
CoCo specific sort of console driver. It' s f ast- 
which is why most Tandy games use it. But 
it's not terribly capable, so most programs 
that don't come from Tandy use one of the 
others. It does have the advantage that it will 
live peaceably with either one of the other 
console driv ers, but unless you plan to run lots 
of Tandy games from your stock boot re- 
move it. The second console driver is Grflntio. 
This is the windowing OS-9 console most 
programs expect In theory, it sacrifices some 
speed for function. In practice, you have to 
have at least Grflnt to do much. And the last 
console choice is only available to folks who 
have the MultiVue package. Windlnt adds 
some extra features to Grflnt- many of the 
fancy menus and bordered windows in 
MultiVue arebuiltinto Windlnt! In fact, many 
programs that 'require ' MultiVue really only 
requireWmdIntThedescriptorTerm_vdgis 
the 32x16 CoCol text screen. Immediately 
replace it withTerm_win.dt which can easily 
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be modified to become an 80 column screen. 
128Kusers may find this is the only 80cohnnn 
window they can 'afford'. The rest of the 
descriptors (the w#.dw series) should all be 
included. They don't takeupmuch room, and 
you will needanumbereddescriptorforeach 
window you (or a program) opens. 

Next thing up is the communications ports. If 
you have an RS-232pack, theofficial driver 
is ACIAPak. There are 2 descriptors - A2 for 
the232Pafc and/ml foramodempakorRS- 
232 modified to use the modempak address. 
The second choice sort of made sense years 
ago- SIO and Al cando 300 baud through the 
bitbanger port Totally useless today! Re- 
move them from bootlist so they can rest in 
peace. Printer and /p use the bitbanger as a 
serialprinterporLNotmuch to say about that- 
if that's where the printer cable ends up, you 
need this pair! 

PIPEMAN: One of the main things OS-9 
adds is the ability to have all this independent 
stuff nmning at the same time. Which brings 
up the musical question, what if I have to 
connect2ofthese programs together? This is 
the set. Even if you haven't used this group 
yet, keep it around. To make up a new boot, 
you first draw up a new outline similar to the 
one above. Most changes are made from 
right to left- first looking at the descriptors, 
men the drivers, then perhaps the managers. 
If anew descriptor will do, justreplace the old 
one with the new. 

When removing modules, first pull out the 
unneeded descriptors, then any drivers that 
no longer have anything to drive. So if the 
300bps bitbanger driver /tl goes, its driver 
SIO can go, since there is nothing left in it's 
section of the outline. When adding new 
system software, work from left to right 
Rgureout whichmanager is responsible, men 
add the new driver and descriptors) in that 
manager's section. Li general, anything that 
looks like a disk drive (hard disk, ramdisk, 
etc.) is RBF. Tapes, terminals, and modems 
are SCR 

There are certain limitations onhow abootlist 
can be set up, and these are the main 
guidelines: The entire OS-9 system has to fit 
in a single 64K 'process space*. This size is 
dictated by the address range of the 6809 
itself- switching GIME registers while 'in- 
side* the operating system is not allowed! 
Certain utilities use this 'system ram' for data, 
most notably format, which uses a whopping 
6K! When you get an error 237 (System 
RAM full) the amountof stuffinyour bootlist, 
plus any data space system utilities are using 
has wentover this HmitTheonly solutionis to 



remove some stuff from boot. A few likely 
suspects were mentioned above (SIO, Al, 
vdgint) and there is a third. CC3Go has no 
reason to be in os9boot It's only used once, 
when the CoCo starts up, then it's stuck- 
being mushed into the boot, there's no way to 
get rid of it! Put CC3Go in the root (main) 
directory of your boot disk, and delete it from 
bootlist. OS-9 will find it, use it, and delete it 
from RAM when done. 

The second consideration is squashing a col- 
lection of problems known as the BLOB, or 
Boot list Order Bug. The symptom is a boot 
that just won't, even though it looks perfect. 
There are a lot of theories and fixes for the 
BLOB, ranging from total voodoo to some 
well thought out cures. The thing to remem- 
ber is the BLOB is a whole collection of 
problems, so there is no 'One True Fix*. 
Positionis critical.The GIME splits aCoCo's 
RAM into8K blocks. Managers like to find 
the drivers and descriptors they manage in me 
same 8K block of RAM as they occupy. By 
keeping the outline format above, there is a 
better chance that each subsection will end up 
in the same block. Sometimes a section will 
start too close to the end of a block anyway, 
and will 'run over* into the next one. If an 
otherwise goodlookmgbootjustwfflnot work, 
stir! There are 2 modules mat don't really 
belong anyplace- try moving Init or Clock to 
the other endof me list Anotherpossibility is 
changing the order of the three main sections 
RBF, SCF, and PIPEMAN. One fact to 
remember is, once another boot is made up, all 
bets are off! Don' t automatically include this 
or that 'fix' just because it was needed last 
time- notonly may itnotbe needed, butmay 
cause the problem. After a few years you 
end up with a fix to fix the fix that fixed the 
original problem, which might have disap- 
peared by itself on the new boot! 

Now to actually make aboot disk. If you are 
like me, the first thing you did was read the 
Getting Started section of the manual, which 
says use Configtoniakenewbootdisks.Idid, 
and frankly Config is a terrible program. The 
intention is good, but mere are just to many 
limitations. Instead, use that most cryptic pair 
of OS-9 utilities- OS9gen and Dsave. 
WATT! ! COMEBACK! Neitheris as hard to 
use as the manual leads one to believe. OS9gen 
only wants one thing- the bootlist we have 
been talking about Chd to the modules direc- 
tory on a copy of your B09 disk. Copy the 
stock list to another file, using a name mat will 
mean something six months from now! It's a 
pain to wade through a dozen files withnames 
likeboot2.1a, looking for the one mat supports 
double sided floppies, speechpak, andTandy 
game gfx. Much better to put up with die 



extra typing now and callMbootVDGdsSSP. 
Using any word processor or text editor (OS- 
9 has Edit with it), edit this copy to reflect 
what you want in thenew boot Double check 
the final version against the description above, 
just to make sure everything is in there, and in 
the right place. Multi Vue owners should re- 
place Grflnt with Windlnt and add the extra 
window descriptors w8 through wl5 (re- 
member to copy the modules themselves 
from theMVuemodules dir to mis one). With 
the new bootlist made up, put the B 09 disk in 
drive/dl,andafresWyformatteddiskin/dO; 
chdto/dl/modules, and then typeos9gen/d0 
cnewbootlist This willputexactly one file on 
thenew boot disk-os9bootTogettherestof 
the System Master on it put the Tandy Sys- 
temMasterdiskm/dl,chd/dl;chx/dl/cmds, 
then dsave /dl /d0 ! shell. 

Single driveusers have a problem here. Dsave 
can't do single drive backups. There is a way, 
as long as the new boot is smaller than the 
original. If you have removed the three mod- 
ules we spoke of earlier, this will probably 
work. Start with a backup of your old System 
Master.DeleteOS9bootInserttheb09disk, 
chx/dO/cmd^;chd/o^/modules, menos9gen/ 
d0-s<newbootlist In either case, if you have 
removed cc3go from the bootlist make sure 
to copy it from the modules directory to die 
root directory of the new Master. Otherwise 
your CC3 won't go! 

Next time: What Tandy didn't sell you. I'll 
also answer any questions received about 
starting OS-9 1 can be contacted through the 
magazine, Delphi (RICKULAND), Internet 
(rickuland@delphLcom), or good old U.S. 
Mail (Rick Ulland, 449 S. 90th Street West 
Allis, WI 53214). Remember... theonry stu- 
pid question is the one you didn't ask (I won't 
print your name if reques t ed...)! If I didn't 
explain something fully enough, and you can't 
seem to figure it out write! That's what this 
cohinmUaU about., teaching youhowto get 
started with OS-9. 
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Rick Ulland is the owner cfCoNecL He is 
an avid OS-9 user and hardware builder. 
He currently uses a CoCo 3 system. 
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0S-9/0SK Answers! 

Using a mouse with CoCo BASIC09. 



Joel Matthew Hegberg 



Oh my! Is it summer already? It seems to 
have come so fast! Time sure flies when 
you're having fun* and with all the recent 
CoCoFests, that exactly what a lot of us have 
been having ! It's great to see our computers 
and operating systems getting so much sup- 
port with so many gatherings. 

One of my favorite parts of the fests is seeing 
what other people have been doing with OS- 
9 and learning/teaching new tricks to one 
another. I generally deal with large applica- 
tions, but applications are just a consolidation 
of a great deal of software techniques that an 
author (or programming team) has learned. 
WhatI hope to accomplish with this monthly 
column is the sharing of software techniques 
and algorithms that are useful under OS -9, 
regardless of the programming language be- 
ing used. Be it Assembly, BASIC, C, etc., I 
welcome any comments or suggestions that 
you may have for other OS-9 programmers. 

Additionally, any questions you may have 
regarding OS-9 applications programming are 
welcome. I've written a variety of applica- 
tions under OS-9, including a graphical word 
processor, a graphical desktop, graphical 
clock, games, utilities, and more. I will do my 
best to answer your questions as simply as 
possible, although technicality is inevitable 
with this type of column. 

For those readers who are not yet into OS -9: 
Believe it ornot, Iknowhowyou feel (Really, 
I do!). It took me five tries to get into OS-9. 
The first four times each ended up in failure 
and frustration, and a vow to give up on OS- 
9 I remember attending fests when Marty 
Goodman, during his seminars, would ask all 
the OS -9 'ers to raise their hands, and I would 
silently scowl at the growing size of the OS- 
9 user base. I didn't see anything so great 
about OS-9, yet more and more users were 
migrating to it, and with few complaints. Let 
me say if you just don't like OS-9, but have 
never really been able to play around with it 
yet, you're missing out. It's that simple. I 
wouldhaveneverbelieveditmyself, being the 
devout DECB programmer I once was, but it 
really is better to have an operating system 
that can do alot atone time, even if there are 
fewer "flashy" programs available for it 
WhatOS-9 lacks in flashy programs, it makes 
up a hundred fold in work efficiency. 

For you OS-9 readers out there, I know a lot 
of you are saying, "I love using OS-9, but I 
can 't seem to write my own programs under 



it." Well, you've turned to the right page, my 
fnend! Write in any problems you may be 
having, including source code snipits, and 
we'll set you on the right track! After all, 
that's what this new magazine is all about — 
Support! Now, on with this month's topic... 

Making your CoCo BASIC09 
programs mouseable! 

Over the past couple of years, a few people 
have asked me how to use the mouse under 
BASIC09. Unfortunately, the GFX2 module 
does not provide any mouse-reading capabili- 
ties. To read the mouse you must use OS-9 
system calls, which can be alittle confusing to 
the average B ASIC09 programmer. This ar- 
ticle may be difficult for a non- or novice- 
programmer to comprehend, butlbelieve an 
average programmer will understand. 

Toreadinmouse data, thelSGetStt (GetStat) 
system call is used along with the_GS_Mouse 
call (which is incorrectly labeled_SS_Mouse 
on page 8-123 of the Technical Reference 
manual). When this call is used, a 32-byte 
mouse datapacket is sent to your programfor 
examination. Here are some important off- 
sets inside the mouse data packet: 



what I've just tried to explain: 

TYPEregisters=«c,a,b > dp:byte; x,y,u:integer 

\(* for "syscall"*) 

DIM regsrregisters \ (* for "syscall" *) 

DIM callcode:byte \(* for "syscall" *) 

DIM mouse_data:string[32] \ (* 32-byte 

area where I want my mouse data to go *) 

DIM valid4nouse_xjnouse_y, button. A, 

button_B:integer \(* For next example... *) 

regs.a=0 

regs.b=$89 

regs.x=ADDR(mouse_data) 

regs.y=0 

caUcode==$8D\(*$8DistheI$GetSttcode*) 

run syscalKcallcodej-egs) 

There, not too difficult After that is run, 
"mouse_data" will contain the mouse data 
packet given to you by OS -9 (isn't that nice of 
OS-9). Now, all you need to do is PEEK at 
the contents of "mouse_data" and you can 
extract all the information you need from the 
packet. Glancing again at pg 8-123 in the 
Technical Reference manual, you can see 
that upon exit, regis ter X still contains the data 
storage area address that we gave it before 
we ran "syscall". So, to get the mouse's X- 
and Y-posiuons, button, and pt_valid informa- 
tion, you could use: 



Offset Size Data Contained 




8 
9 

24 
26 
(values in decimal) 



1 pt_valid... if user is in a different window. 
1 pt.cbsa... 1 if mouse button A is pressed. 

1 pt_cbsb... 1 if mouse button B is pressed. 

2 pt_acx... Mouse's X -position. 
2 pt_acy... Mouse's Y-position. 



When using "syscall" (for information, see 
pg 1 1-166 in the BASIC09 manual) and the 
_GS_Mouse windowing function, you must 
load the X -register with the address of the 
area you have reserved for the mouse data 
packet to be loaded into, which must be at 
least32 bytes inlength. Also, (looking atpg8- 
1 23 in theTechnical Reference manual) reg- 
ister A needs the path number, B needs to be 
$89 (the _GS_Mouse function code), and Y 
is the **port select". This sounds a lot more 
complex than it really is. The path number 
should be 1, which refers to the current 
window a program is running in, and **port 
select" should always be 0, for automatic 
selection, since you do not know if the user 
has their mouse in the left or right joy stick 
port To get the address of your reserved 
area, use the ADDR function (pg 1 1-6 in the 
BASIC09 manual). Here's how to set-up 



valid=PEEK(regs.x) 

button_A=PEEK(regs.x+8) 

buttonB=PEEK(regs.x+9) 

inau9e_x=*m<tegsA+21)^^ 

mouse_y=*raK&egSA43fiJ*2^ 

print "Mouse data; valid:";valid;" cbsa:"; 

button_A; " cbsb:";button_B; 

print " X:";mouse_x;" Y:";mouse_y 

Again, not so bad. Realize that this program 
will not display the mouse pointer on screen, 
only mouse information. 

The best way to learn, in my opinion, is 
through example, so I'm including a program 
listing that will show how you can also check 
for keypresses as well as mouse button clicks 
withoutpausing program operation. It is also 
important not to waste CPU time if the user 
has moved to a different window (which is 
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when pLvalid is 0). You do this by going to 
sleep. The sleep technique is also shown in 
the program listing (Note: All of the page 
numbers given in the program listing are in 
the Technical Reference manual.)- This pro- 
gram must be run from a graphics screen. To 
create the proper screen, use the command: 

WCREATE/Wx -s=8 0040 2404 2 
SHELLi=/Wx& 

where x is replaced with the windownumber 
you wish to create. Use the CLEAR key to 
find the newly created window and run the 
program from there. This will give you a 40- 
column (320-pixel) graphics screen. 

Routine 10000 merely updates the mouse 
pointer on the screen (and loads in the mouse 
data packet into *'mouse_data t *). Routine 
15000 (which calls routine 10000 to update 
the mouse, and get the mouse data packet) 
simply waits until the mouse button is not 
being pressed and the user is in the current 
window. Routine20000wiUurxiatethemouse 
pointer, check for a mouse click, check for a 
keypress, and sleep if the user leaves to a 
different window. Comments are included in 
the source code to help explain what's going 
on each step of the way. 

PROCEDURE MouseTest 

TYPE registers»€c,a,b t dp:byte; x,y,u: integer 

dim regs:registers 

dim callcode:byte 

dimmouse_X4nouse_y:rnteger 

dim mouse_data:string[32] 

dim keypressS:string[ 1 ] 

gosubSOOO 

1 Ogosubl 5000 \(* Make sure mouse button 
is not pressed*) 

gosub 20000 \(* Wait until mouse button or 
key is pressed *) 
run gfx2CCURXY",0,20) 
run gfe2("EREOLINE") 
if keypressS^"" then 

print "Mouse click at X^nnouse^x;**, 
Y: M ;mouse_y; 
else 

print "Keypress: ";keypress$; 
endif 
goto 10 

5000 REM Turn mouse cursor on, 
run grx2CGCSEr\Sca,l) 
return 

10000 REM Urxiatemousepositkmonscreen. 
regs.a=l \ (* Path number 1, which is the 
current window.*) 

regs.b=$89 \(* Code $89 is the SS .Mouse 
function, pg 8-123*) 



regs.x=addr(mouse_data) \ (* Load the 
mouse information into mouse_data * ) 
regs.y=0 \(* Automatic port selection *) 
callcode=S8D \ (* $8D is the BGetStt 
callcode,pg8-54*) 

run syscall^callcode^regs) \(* Go out and get 
the mouse information * ) 
moiKj?=peel<regsji+24)*256>peek(iegsjc+2^ 
\(* Get mouse's X-posinon *) 
mouse_y=peel^regsjt+26)*2564peel<regsj+27) 
\(* Get mouse's Y-position*) 
rungf^ M PUTGC\(mouse_x)/2jnouse_y) 
\ (* Move the mouse to new location * ) 
REM Note in the line above that the x-coor 
is divided by 2. This is only if 
REM you are on a 320-pixel (40 column) 
graphics screen. If you are on a 
REM 64(X-pixd(80column)graphics screen, 
get rid of the 72". 

REM Unfortunately, CoCo-3 Windows 
does not scale the positioning of the 
REM graphics cursor, so the programmer 
must take care of that 
return 

15000 REM Wait until mouse button is re- 
leased and user is in current window, 
gosub 10000 \(* Update mouse position and 
load in mouse data into mouse.data *) 
if peek(regs.x+8)o0then 15000 \(* Mouse 
button is pressed, so wait *) 
if peek(regs.x)=0 then 15000 \(* User is in 
another window, so wait *) 
return 

20000 REM Wait until user clicks mouse 
button or presses a key. 
REM Upon exit, if keypress$= ,m men the 
mouse button was pressed, and mouse 
REM coordinates are in mouse_x and 
mouse_y. 

REM If keypressSo*^ then a key was 
pressed, and is stored in keypressS. 
keypress$=~* \ (* Clear out keypressS *) 
20010 gosub 10000 \(* Update mouse and 
load mouse data packet *) 
if peek(regsjt)=0 then \ (* The user is in a 
different window... *) 

callcode=$0A \(* to go to sleep! Don't 
wasteCPUtime! $0AisF$Sleepcode 1 pg8- 
35*) 

regs Jt=60 \(* Sleep for 60 ticks, which is 
about 1 second *) 

run syscall(callcode,regs) \(* Go to sleep*) 
goto 20000 \(* Ok, awake again, go back 
and see if user has returned. *) 
endif 

if peek(regs Jt+8)o0 then \(* Mouse button 
was pressed *) 
return \(* Exit back to main progr am . *) 
endif 

regs.a=0 \(* path #0, keyboard input *) 
regs.b=l \(* Code 1 is SS.RDY function to 
see if keyboard data is waiting, pg 
8-113*) 



callcode=$8D \(* $8D is BGetStt code, pg 

8-54*) 

run syscall(callcode,regs) \(* Go and check 

if there is any keyboard data wai 

ting.*) 

if regs.bo$F6 then \ (* There is data 
waiting! *) 

callcode=$89 \ (* $89 is BRead code, to 
read data from a device. *) 

regs.a=0 \ (* Path #0, keyboard input *) 

regs.y=l \(* Readonly 1 byte/keypress. *) 

regsjt=addr(keypress$) \(* Load the data 
into keypressS*) 

run syscall(callcode,regs) \(* Go and read 
the keyboard data *) 

return \(* Exit back to main p ro gram . *) 
endif 

goto 200 10 \(* No keypress or mouse click, 
so go back and try again. *) 

Any questions or comments for OS-9/OSK 
Answers! may be sent to Joel Matthew 
Hegberg in care of 68Micros magazine or 
directly to him at 932N. 12thStreet, Dekalb, 
IL601 15. You may also reach Joel electroni- 
cally at the following e-mail addresses: 

JOELHEGBERGonDelphi. 
JifEGBERGonGEnie. 

joemegberg@delphixom on theinternet 




Joel Matthew Hegberg has been pro- 
gramming on a CoCo> both in DECB 
and OS-9, for many years. He also 
programs for the MM 11. Sub-Etha 
Software carries many of Joel's pro- 
grams. Here he is shown trying to 
answer a difficult question at the 1993 
Chicago CoCoFest... 
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Programming in "C"... an introduction to the language R G. Swygert 



An editors work is never done! Bill 
Sgambati, author of "CoCo-C", called 
just last week and told me he wouldn't 
be able to start his column with the first 
issue due to time constraints. Rather 
than skip the column, I decided to write 
up a quick introduction to C and why it 
has become so popular. I will also 
point out the differences between Bill's 
CoCo-C and the Microware OS-9 C 
compiler provided by Tandy. 

First, a litUe history of C. Dennis Ritchie 
originally designed and implemented 
C on a Digital Equipment Corp. PDP- 
1 1 computer for Bell Laboratories un- 
der the UNDC operating system. I don't 
know if there was ever an "A" pro- 
gramming language, but there was defi- 
nitely a **B'\ C has some of the charac- 
teristics of B, but is not a direct de- 
scendant of it C was written to be easy 
to understand and well structured, 
something that would produce source 
code that could be easily understood by 
the programmer compared to other 
popular languages. 

One reason C has become so popular is 
that it does not deal direcdy with the 
hardware it is running on. All I/O must 
be supplied by functions written for a 
particular machine. This means that the 
C source will compile with minor, or in 
some cases no, changes on nearly any 
platform. Need to do disk I/O? Call the 
disk I/O function. The compiler written 
for you particular computer will then 
add that function to your compiled code. 
Only the compiler itself is machine 
dependant So all one has to do is be- 
come familiar with a particular com- 
piler, not learn a complete new lan- 
guage, to move from one machine to 
another. Then one can start learning 
how to implement that machines spe- 
cial features through the compiler's 
unique functions. 

Another reason for C's popularity is 
that it is not restricted to any one pro- 
gram type- it seems to do almost any- 
thing well! It's modularity, generality, 
portability, efficiency, and few restric- 



tions make it an ideal language to learn. 
In many cases, C's efficiency makes it 
unnecessary to write assembly language 
sub-routines. An example is the UNIX 
and OS-9000 operating systems. UNIX 
consists of around 13,000 lines of 
source code. Of those, only about 800 
are in assembler. 

It is suggested that one pick up a copy 
of "The C Programming Language** by 
Brian Kernighan and Dennis Ritchie. 
Ritchie wrote the first C language, 
Kernighan helped him refine and add to 
it The current edition covers ANSI C 
and is available at most B. Dalton book 
stores (published by Prentic-Hall). If 
the store doesn't have it in stock, they 
can order it for you. There are some 
minor differences between the origi- 
nal Kernighan and Ritchie (K&R) stan- 
dard as used by Microware (Tandy) and 
CoCo-C, but most people have no prob- 
lem using the book as a guide. The 
Microware or Infinitum manuals should 
clear up any differences when encoun- 
tered. 

The program Bill intends to use for the 
following articles in this series is a file 
comparison utility. This is something 
DECB lacks, but there are OS-9 utili- 
ties that provide this function. The 
excercise being accomplished by the 
series is an introduction to C program- 
ming through writing an implementing 
a short utility. The source code for this 
utility should work with any C com- 
piler on any platform. It was developed 
using the CoCo-C compiler, but other 
platforms and compilers should present 
no problems. Whenever possible, any 
minor changes will be noted before 
hand in the text If a few slip through, 
I'm sure readers will point them out 
(and hopefully some knowledgable 
readers will help out with the correc- 
tions!). 

If you don'talready haveanOS-9/6809 
(Tandy) C compiler, you might be out 
of luck. It is possible to order one from 
Tandy Software Assembly through your 
local Radio Shack dealer. It will be at 



the last published price ($79.95... I 
THINK! may be as high as $99.95... 
inquire! ) and the manual will be a photo 
copy produced from Tandy's micro- 
film archives. The disk will be from 
Tandy's archives also, so it won't have 
the pretty OS-9 label on it (big deal!). 
Used copies are going anywhere from 
$40 to $70 - if you can find one (try 
CoNect.. they occasionally have a 
copy). Your only other choice is 
Infinitum Technology's "CoCo-C", 
which is written for Disk BASIC 
(DECB). Of course, if you are working 
with one of the OSK (OS-9/68000) 
machines, you probably got a C com- 
piler with it There is a "freeware" 
version of C for OS-9 68000 also. 
More details on how to obtain this will 
be passed along when the information 
becomes available. Til also write a mini 
review of it 

A Review of Infinitum Technology's 
CoCo-C 

The introduction in the manual is hard 
to beat for a quick mn-down of just 
what CoCo-C is. I quote: 
"CoCo-C is a complete programming 
environment designed to be used on a 
CoCo 1, 2, or 3 with a minimum of 64K 
of memory and at least one disk drive. 
The programs contained within CoCo- 
C are: an Editor, a C compiler, an As- 
sembler, and a Library Linker. All these 
programs run under the CoCo-c's Com- 
mand Coordinator" (really just a 
menuing system)"for speed and sim- 
plicity. The compiler is capable of pro- 
ducing position independent (relocat- 
able) code, or absolute (ROM-able) 
code. All programs created with CoCo- 
C are in machine language and do not 
require a 4 run-time' program for ex- 
ecution. LOADM and EXEC is all that 
is needed to run a user-created CoCo- 
C program. The CoCo-C Function Li- 
brary supports many of the standard C 
library functions along with several 
* special' functions which are unique to 
the CoCo. CoCo-C also supports mixed 
programming, so that you can combine 
C, Assembler, and BASIC commands 
into one program." End of quote. 
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C Programming. 



Beginner's Showcase, continued from page 21. listing of datedtr. 



Over 90 functions arc in the CoCo-C 
function library. Some functions, how- 
ever, had to be left out. CoCo-C is far 
from a small-C though. It has 85-90% 
of the functions in the Microware/Tandy 
OS-9 compiler. Such things as floating 
point math simply couldn't be done 
while maintaining compatibility with 
Disk BASIC. There are no undocu- 
mented ROM calls used, and CoCo-C 
or any programs written with it are 
100% DECB compatible. It will even 
run on a hard disk or from a RAM disk, 
provided the DOS operating the hard 
disk is 100% DECB compatible as well 
(it was tested under RGBDOS and with 
several 35 track RAM disks). One of 
the stipulations for guaranteed com- 
patibility is that the hard/RAM drive 
DOS exactly emulates 35 track, single 
sided, 18 sctor/track, 256 byte/sector 
"standard" Tandy drives. The program 
should also work with ROMs that have 
been modified for 40 or 80 tracks, 
since the compiler calls these routines 
from the ROM. 40/80 track operation 
isNOT guaranteed by the author though. 

I haven't tried writing any programs in 
C using CoCo-C, nor have I tried com- 
piling any of the example programs as 
of yet. Fm waiting for this series to 
begin in earnest! What I can say is that 
the manual is professionally typeset 
and printed with a laser printer. It looks 
very good and is extremely well written 
and easy to follow. Bill definately did 
his homework on this one! This has to 
be one of the BEST, easiest to follow 
software manual I have ever seen! Us- 
ing the examples given, one should 
immediately be able to start using the 
compiler. With just a little research, 
source cock written for another com- 
piler should be easily converted to 
CoCo-C, as long as one stays within the 
constraints of the CoCo itself (i.e.- 
CGA grapohics screens should be 
convertable, forget EGA or VGA!). 



5 WIDTH 40:CLS 4:'DATEDTR 

6 REM COPYRIGHT ?B. BLACKWELL 
& FARNA SYSTEMS, 1993 

8 REM FROM AUG 1993 68*micros 
10 PRINT"********* Pete Black 
well ************** 

15 PRINT"****** 1408 1/2 

McFadden St. ********" 

20 PRINT"****** Paris TN 

38242-3210 ********" 

25 PRINT"********** JUNE 29, 

19 9 3 

************":PRINT:PRINT 

30 print"********** <press a 

key> ************" ; pRiNT 

35 EXEC 44539 

40 CLS 8 

45 PRINT"!!!!!!!!!!! CAUTION 

M!!!!!!!!!!!!!!!":PRINT 

50 PRINT" If your system 

will not accept the high 

speed poke and/or your drives 

will not operate at 6ms; EDIT 

Line 100 for satisfactory 

operation." 

55 PRINT:PRINT" 

":PRINT:PRINT 

60 PRINT" This program 

should work, with no 

problem, on the CoCo 1 and 

CoCo 2. You will, however, 

have to EDIT Lines 5 & 

100; DELETE Line 110 

and EDIT the prompt and 

instruction Lines to prop- 

e r 1 y " ; 

65 PRINT" fit the 32 column 

screen. ":PRINT 

70 PRINT:PRINT"********** 

<press a key> **********♦*♦« 

75 EXEC 44539 

100 POKE 65497,0:POKE 55232,0: 

POKE 55318,20 

1 10 ON BRK GOTO 430:ON ERR GOTO 

430 

120 L$="L3T5O3V30GF": M$= 

"L3T5O1V30B-E" 

130 PLAY L$+M$+M$+L$:CLS 3 

140 PRINT"...<DATEDTR>.. 

Change/Add/Delete data":PRINT 

150 PLAY L$ 

160 INPUT"Name of file (do not 

use /, ., or :)...";F$ 

170 PLAY M$ 

180 INPUT"EXT ";ES 

190 PLAY L$ 

200 INPUT"Drive # .. (0- 

5)";D$ 

210 D=VAL(D$):K$=F$+7 



" + E$ + ":" + D$ 

220 OPEN"I",#l,K$ 

230 OPEN"0",#2 t "NEW/ 

DAT" + ":" + D$ 

240 IF EOF(l)=-l THEN 

PRINT:PRINT"**** No more data 

on disk ****":PRINT:GOTO 280 

250 INPUT#1,A$ 

260 PLAY"T60L1C":CLS 3:PRINT 

K$:PRINT 

270 PRINT" Data 

I tern...."; AS 

280 PRINT:PRINT"Press <N>=no 

change:: <A>=add data:: 

<C>=change data::<D>=delete 

data <Q>=quit::" 

290 I$=INKEY$:IF I$="N"OR 

I$="n*THEN 400 ELSEIF 

I$="A"OR I$="a"THEN 370 

ELSEIF I$="C"OR I$="c"THEN 

330 ELSEIF I$*="D"OR 

I$="d"THEN 300 ELSEIF 

I$="Q"OR I$="q»THEN 430 

ELSE290 

300 CLS 8:PRINT" Old data 

name: ";A$ 

310 PRINT:PRINT"!!!! Arc You 

Sure? <Y/N>";:PRINT 

320 S$=INKEY$:IF SS=""THEN 

320 ELSEIF S$="Y"OR 

S$="y"THEN 240 ELSEIF 

S$-"N"OR S$="n"THEN CLS 3 

GOTO 260 
330 CLS 6:PRINT"01d data name: 
" * A $ 

340 PRINTrPRINT"... Change 
data to: M ; 
350 INPUT X$ 
360 GOTO 410 

370 CLS 8:PRINT:PRINT"New data 
to add:"; 

380 INPUT X$ 
390 GOTO 410 
400 X$=A$ 
410 WRITE#2,X$ 
420 GOTO 240 
430 CLOSE#l:CLOSE#2 
440 KILL K$ 

450 RENAME"NEW/DAT"+":"+D$ 
TO KS 

460 PLAY M$+L$+L$+M$ : CLS 5 : 
DIR 
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Repackaging the Color Computer. .. 



F.G. Swygert 



How many times have you wondered if 
there were an easy, practical way to rid 
your desk of the cable mess present 
with most full blown CoCo systems? 
Most of the articles the author has read 
describe mounting the CoCo and a 
Multi-Pak Interface (MPI) in a full size 
AT style case. This works well, but is 
expensive and requires a myriad of 
cables between the CoCo motherboard 
and the back of the case. 

There are several easier solutions! The 
main focus in this series of articles will 
be the easiest route for repackaging. 
Some light soldering will be required, 
but not a whole lot No chips will have 
to be desoldered, just a few connec- 
tions to the CoCo motherboard... and 
even those can be eliminated! 

The first order of business when 
repackaging is to consider what is 
needed in the system. Do you have a 
need (or perceive a future need) for a 
MPI? Can you get by without it? The 
MPI takes up a LOT of room in any 
case. There are alternatives to it that are 
much easier to repackage. 

The most obvious is a simple " Y" cable. 
As long as the cable is kept short (pref- 
erably under six inches) there are few 
problems. Since a PC type or similar 
power supply is used in most 
repackaging projects (all presented 
here!), +/-12V can easily be added to a 
Y cable for items such as the Burke & 
Buike CoCoXT hard drive interface. 
The disadvantage is that only two de- 
vices are reliably supported. If running 
OS-9 with a B&B hard drive, floppy 
controller, and RS-232 Pak... 

Rick Ulland, the owner of CoNect, has 
been very busy working an expansion 
device for the CoCo: the "XPander". 
This board plugs into the side of the 
CoCo and stands perpendicular to it 
(like a "T"). The internal slots mount 
devices over the motherboard. The 
XPander was designed to fit in a modi- 
fied CoCo case bottom (which is in- 
cluded). It has two internal and one 



external cartridge connectors (the ex- 
ternal is in the same position as the 
ROM port!). Everything is arranged in 
such a way that all are inside the CoCo 
case. A true RS-232 port is built into 
the XPander board, making an add-on 
port unnecessary for most users. Used 
without the new case bottom, the 
Xpander is perfect for mounting a CoCo 
in some PC cases. The entire CoCo/ 
Xpanderpackage with add-on cards (no 
card in the ROM pak slot) requires only 
0.2 cubic feet of space (12"x7"x3"), so 
it will easily fit in an XT or slim-line 
case. Check the dimensions inside ex- 
tra small cases of those odd computers 
out there! 

The Howard Medical Slot Pak (SP) 
presents some of the same problems 
the MPI does. The most difficult to 
overcome is the height of the cartridges. 
A tall case is required to clear long 
cartridges such as older disk drive con- 
trollers, Tandy RS-232 Paks, and B&B 
hard drive adapters. A short ribbon cable 
is necessary to turn the SP (or MPI) on 
its side 90 degrees to the CoCo. 

The DISTO Super Controllers are an 
ideal solution. They have an internal 
mini expansion bus and several combi- 
nation cards, such as the 4-in-l board 
(parallel port, serial port, SCSI/SASI 
hard drive controller, and real time 
clock). All this is contained in the space 
of a long type disk controller case. 
Tony DiStefano still has some of these 
products available, but there may be no 
more once the supply is exhausted. 

Careful planning will help dictate what 
type of case can be used Availability is 
another. Most major cities now have 
computer salvage or used computer 
equipment outlets, such as Marietta 
Computer Salvage in Georgia (near 
Atlanta, 404-977-9377). There are also 
mail order firms such as HK Computer 
(3959 Beltline, Addison, TX 75244, 
phone 214-484-6447) and TimeLine 
(23605 Telo Ave., Torrance, CA 
90505, phone 800-872-8878) are also 
a good source for used and surplus 



cases, monitors, and disk drives. Prices 
vary from cheap to high... call or write 
for price lists. Much of the equipment 
considered obsolete is perfectly suited 
for the CoCo (5.25" disk drives, com- 
posite monitors, etc.) and in high sup- 
ply and low demand, creating low prices. 
Some of the other obsolete items are in 
demand or rare in the used market and 
command higher than expected prices. 

Pawn shops aren't usually a good source 
for used equipment They usually de- 
mand high prices, though there are ex- 
ceptions. You can always make a rea- 
sonable offer then leave a name and 
phone number in case the owner recon- 
siders... 

Local flea markets, the Salvation Army, 
and other thrift stores occasionally turn 
up something in a usable case. Prices 
vary widely! Some of the S A directors 
put high prices on ANY type of com- 
puter equipment, others seem to have 
some idea of what they are looking at 
Owners remember most what they 
originally paid for that old XT eight 
years ago..* 

Ham fests and computer shows are the 
ideal places to look for used equipment 
and cases. Many dealers bring out there 
obsolete or hard to get rid of items to 
the shows and fests. Many ham users 
have computers to run their equipment 
or assist in calculations. The CoCo was 
once real popular with hams, and many 
often show up at the hamfestswap meets. 

Assess your needs, see what is avail- 
able, thai decide on a case type. Do you 
need portability? Then try to find a 
KayProll, 4, or 10 case (as shown on 
the cover). Just want a neat system 
without an MPI? The Tandy 2000 case 
is ideal, and even has a "factory" look to 
it., who remembers that a Tandy 2000 
was IBM compatible and not a "super 
CoCo" anyway? If a PCcase is adopted, 
make sure the power supply is raised 
for the motherboard to slide under it. If 
an MPI is necessary , a full size AT case 
may be required. 
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The next consideration is the keyboard. 
Most cases will require an extended 
keyboard cable. One might be able to 
eliminate this step if mounting in a 
Tandy 100QEX/HX or Apple D case, 
but even a Model II/3/4 case will need 
a short extension cable. 

The connectors aren't as hard to get as 
one would expect., a little ingenuity 
must be used! Use a 34 pin card edge 
connector for the keyboard mylar strip 
and a 16pin single row header, half a 40 
pin chip socket, or 20 pin single inline 
chip socket to press in the mother- 
board female keyboard socket. 

Separate the wires on each end of a 
length of ribbon cable (up to six feet 
long) for about two inches. Press the 
wires into a crimp-on card edge con- 
nector so that only one side of the 
connector is used. Cut a l"xl 5/8" piece 
of card board thick enough to firmly 
press the mylar strip of the CoCo key- 
board against the contacts of the con- 
nector. Note that only one side of the 
mylar strip makes contact, and that one 
pin is unused (this one is shorter than 
the others). The smooth side of the 
strip makes no electrical contacts. 

The other end of the cable is a little 
trickier to make. If using heasder(row 
of double ended pins) it isn't hard... just 
solder the ribbon cable ends to one side 
of the pins. If using a chip socket, first 
strip about 1/8" of each wire then tin 
them with solder. Place a bit of flux in 
the socket holes or on the ends of each 
wire. Insert the tinned ends into the 
socket one by one and carefully touch 
briefly with the soldering iron. This 
will be the weak point in the system. If 
at all possible firmly tape the ribbon 
cable inside the case to prevent pulling 
out of the motherboard connector. The 
preferred method is to make a short 
cable between the motherboard and a 
male DB-2S connector mounted on the 
case, then use a matching female DB- 
25 on the end of the keyboard cable. 
One final note- make sure the lines on 
both ends of the cable(s) all line up 
correctly! The unused pins on the DB- 
25 can be used for keyboard mounted 
power LEDs, reset button, etc. 




Completed remote keyboard cables. Note how ribbon cable wires are spread apart. 
Firmly tape the mylar strip and connector to the back of the keyaboard! 




CoCo keyboard going in a KayProIJ housing. Note two marked cutouts. Upper 

cutout allows wrist support at bottom of housing, required notching monitor bezel 

for clearance. Kay P roll keyboard will give up keys for a future number pad! 



Now what about a case for the key- 
board? Many variations of wood cases 
have been used Some use a modified 
case from another computer keyboard, 
such as was done for the portable 
KayProII/CoCo3 conversion. The 
original CoCo case can also be used. 
FARNA Systems has some CoCo 3 
keyboards and cases available for $12 
(includes shipping) if (Hie desires to 
keep the original case. I have seen CoCo 
cases used intact and others with the 
back hacked off and covered over with 
cardboard or sheet plastic! 



If making a remote keyboard and not 
repackaging, replace the original key- 
board with a wood or cardboard cutout 
This is an ideal mounting place for an 
external connector, front reset button, 
and power LED. 

In the next issue we will go over con- 
necting a PC type power supply to the 
CoCo motherboard and detail installa- 
tion in a KayProH portable case. A 
Tandy 2000 and PC type cases will be 
discussed in the third installment of 
this series. 
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Beginner's Showcase 



Programmers of all skill levels will appear here. The emphasis is on short, easy to type in programs 

that illustrate programming techniques. Typing in examples is a great learning tool ! If you have a 

short program or subroutine in any language, drop us a line! Any program/subroutine printed may 

be used by anyone within their programs, even commercial programs, as long as credit is given the 

author and magazine within the code (REM statements^andjoffln^itfltiorK 



D ATREDER is a short program designed 
to read DAT and TXT files directly from the 
disk. It has an option to either print to the 
screen or to the printer. Most of the neces- 
sary instructions are found in the body of the 
program; however, a few additional precau- 
tions/instructions can do no harm. If your 
system has trouble with the high speed poke 
[ POKE 65497,0 J, this should be edited out 
Also, if your drives will not work at 6ms, these 
pokes [ POKE 55232,0 : POKE 55318,20 ] 
shouldbeeditedoutalso.Thehighspeedpoke 
and the disk timing pokes are found in Line 
1 00. The printer options have been set up for 
the Radio Shack DMP-105. If you have a 
different printer, you will probably need to 
change these options. The printer options are 
found in Line 3 80 and Line 390. 

D ATEDTR allows you to read data from a 
disk file. As you read the data you have the 
option to (a) retain the old data, as is; (b) 
change the name (or number) of the data (of 
course, you lose the old data); (c) add data to 
the file and; (d)deletedata from the file. With 
DATEDTR you can go to and remain in 
lower case mode throughout the program, 
except when setting up "filename/exf at the 
beginning. The same precaudons/instructions 
above (DATREDER) applies to both pro- 
grams, except that DATEDTR has no printer 
options. 

Kyoupress<Q>or<q>or<BREAK>oryou 
experience an error, the programs will (1) 
preserve your old file; (2) save any additions 
you have made; (3) CLOSE your files; (4) 
clear the screen and (5) give you a DIRectory 
listing at the point that whichever occurred. I 
am not sure whether this works in case of a 
drastic ("FATAL") error. I tried to program 
in as much safety as I knew how. 
If anyone does not want to type in the pro- 
grams, you may send me $1.00 plus two (2) 
first class stamps (29 cents), and I'll backup 
you acopy — betteryet — subscribe to FARN A 
Systems microdisk. Mr. Swygert and the 
CoCo's need all the support they can get! 

Happy CoCoing, gentle beings ! ! I 

PJ3.Blackwell 
1408McFaddenSL 
Paris, TN38242-3210 



5 WIDTH 40:CLS 4:'DATREDER 

6 REM COPYRIGHT P.B. 
BLACKWELL & FARNA SYSTEMS, 
1993 

8 REM FROM AUG 93 68'micros 

10 PRINT"***** Pete 

Blackwell **** ***" 

15 PRINT"*** 1408 1/2 

McFadden St. ***" 

20 PRINT"*** Paris TN 

38242-3210 ***" 

25 PRINT"****** JUNE 29, 

1993 **** ****"; PRINT: 

PRINT 

30 PRINT"********* <press 

a key> ***** *** 

***":PRINT 

35 EXEC 44539 

40 CLS 8 

45 PRINT"!!!!!!!!!!! 

CAUTION !!!)!!!!!!!!!!!!!": 

PRINT 

50 PRINT" If your 

system will not accept 

the high speed poke and/or 

your drives will not 

operate at 6ms; EDIT 

Line 100 for satisfactory 

operation." 

55 PRINT: PRINT" 

": PRINT: PRINT 

60 PRINT" This program 

should work, with 

no problem, on the CoCo 1 

and CoCo 2. You 

will, however, have 

to EDIT Lines 5 & 100; 

DELETE Line 110 and 

EDIT the prompt 

and instruction Lines to 

properly"; 

65PRINT" fit the 32 

column screen. ":PRINT 

70 PRINT: PRINT"********** 

<press a key> 

** + ** + *******'• 

75 EXEC 44539 

100 POKE 65497,0:POKE 

55232,0:POKE 55318, 20 

110 ON BRK GOTO 340:ON ERR 

GOTO 340 

120 N=0: M$="L3T5O3V30GF": 

L$= "L5T5O3V30EDG" 

130 PLAY L$+M$ 

140 CLS: 

PRINT"..... Disk File 

Reader ": PRINT 

150 PLAY M$ 



160 INPUT"Name of file to 

be read ";X$ 

170 PLAY M$ 

180 INPUT"EXT (do not use / 

or .)";Y$ 

190 PLAY M$ 

200 INPUT"Drive # (do not 

use :)";Z$ 

210 Z=VAL(Z$):K$=X$+"/ 

" + Y$ + ":" + Z$ 

220 PLAY L$:PRINT: 

PRINT'Send to printer 

<l>=no:: 

<2> = yes:?"; 

230 INPUT P : IF P=2 THEN 

380 

240 OPEN"r\#l,K$ 

250 PLAY L$:CLS 3:PRINT 

K$:PRINT 

260 IF EOF(l)=-l AND P=l 

THEN 310 ELSE IF 

EOF(l)=-l AND P=2 THEN 440 

270 INPUT #1,A$ 

280 N=N+1 : IF P-2 THEN 420 

290 PLAY M$:PRINT:PRINT A$ 

300 GOTO 260 

310 PLAY MS 

320 PRINT:PRINT"Total data 

i t e m s : " ; N 

330 CLOSE #1 

340 PLAY L$:PRINT: 

PRINT"Read another? <Y>:: 

End <N>:: 

DIR <D>::"; 

350 I$=INKEY$:IF 

I$="Y"THEN 120 ELSE IF 

I$="N"THEN 360 ELSE IF 

I$="D" THEN 370 ELSE 350 

360 PLAY M$+L$ : CLS 5 : END 

370 CLS 8 :PLAY L$+M$ : DIR 

Z :GOTO 340 

380 POKE 150,41 

390 PRINT#- 

2,CHR$(27);CHR$(23) 

400 PRINT#- 

2 t TAB(15);CHR$(l5);K$; 

CHR$(14):PRINT#-2 

410 GOTO 240 

420 PRINT#-2,TAB(15);A$ 

430 GOTO 260 

440 PRINT#-2: 

PRINT#-2,TAB(15)"Total data 

i t e m s : " ; N 

450 GOTO 330 



The Listing For 
DATEDTR.BAS 

is found on page 17. 
Sorry for the inconvenience! 
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Now, at the end, you begin to get nervous. Your 
friend* laid you didn 'l have the guts, and now you 
think that maybe they were right You look out the 
window, and the plane does seem terribly high. 
You begin to sweat Hie instructor gives you the 
thumbs up sign, and you know it* s time toga You 
stand at the doorway for what seems an eternity. 
Just when you thought you were going to chicken 
out, you jump into the air. 

A microsecond of sheer terror, followed by 
exilaration. The wind roars by as you tumble to- 
wards the ground. You wait until the last possible 
moment to open your chute, as if daring the ground 
come hit you. The chute opens and you float 
gently to the ground, landing dead center on the 
target Later you tell you' re friends it was nothing. 

Target Jumper is a game for the CoCo 3. The 
object of the game is to score as many points as 
possible by making the skydiver land on a target 

When you run Target Jumper, you are prompted 
on whether you are using an RGB monitor or 
composite monitor (TV). Enter "R" or "C re- 
spectively. After a brief pause, the title and option 
screen appears. First, you are asked what size 
targets you wish to attempt to hit Press "H" for 
huge target*, "R" for regular targets, or **T* for 
tiny targets. Next you are asked whether you want 
the wind to be a factor. Pres s "Y** or "N™ for yes 
or no respectively. 

Tne game screen now appears. The target is the 
light blue box on the bottom edge of the screen. 
Tne wind indicator is also located at the bottom of 
the screen. It points in the direction the wind is 
blowing. The length of the wind indicator shows 
the speed of the wind. 

Your airplane flies from left to right along the top 
of the screen. Press the space bar when you want 
the iky diver to jump. If you do not press the space 
bar, the skydiver will be pushed out of the plane 
when it reaches the right side of the screen* 

Press the up-arrow key to open the skydiver's 
chute. Scoring is based on the height of the skydiver 
when the chute is opened, so be daring and open 
the chute low. Be careful, however, because after 
a certain point it is to late to open the chute and the 
ikydiver will hit with a splat Also, ifyou open the 
chute too soon, you '11 receive no point* even if the 
skydiverlands on target After the chute is opened, 
use the left and right arrow keys to steer the 
skydiver onto the target Both of the skydiver's 
feet must land on the target in order to receive 
points. There are ten jumps per game. 

The maximum number of points per jump is 1 l,and 
themaxiumum scorepergame is 11 (X However, if 
you are playing with the no wind option, all points 
are divided in half . Also, if you fail to open the 
chute, you are penalized five points, whethertherc 
is wind or not. 

Sogoon and do some target jumping. Remember, 
only chickens open their chute high! 

Kenneth Reighard Jr. 
441 Ridgeland Drive 
Toronto, OH 43964 



TARGET 
JUMPER! 



1 'TARGET JUMPER 

2 *BY KENNETH REIGHARD, JR. 

3 ' 

10 REM COPYRIGHT K. REIGHARD JR. A 

FARNA SYSTEMS 1993 

20 REM FROM AUG 93 68'micros 

50 CLStlNPUTMONITOR (R/ 

C) M ;Q$:IF Q$="R" THEN MN=-1 

ELSE IF Q$= W C" THEN MN=0 ELSE 50 

100 POKE 65497,0 

105 GOSUB 325 







110 S=0:JP=10 

115 HCLS 

120 TL=RND(260)+20 

125 IF WF THEN W=.5*(RND(8)-4) 

ELSE W=« 

135 HCOLOR 7:HUNE(0,186)- 

(320,186),PSET 

140 HCOLOR 5:HLINE(TL,186)- 

(TL+TW.191).PSET.BF 

145 HCOLOR 8:HLINE(160,191)- 

(1 60,1 87),PSET:HLINE( 160, 189)- 

(160+W*I0,189),PSET 

150 FOR Z=l TO 1000:NEXT Z 

155 FOR X=0 TO 295 STEP 4 

160 HPUT(X,0)-(X+25,10),3 

165 IF INKEY$=CHR$(32) THEN 175 

170 NEXT X 

175 HUNE(X,0)-(X+25,10),PRESET,BF 

180 Y=0 

185 IF INKEY$=CHR$(94) THEN IF 

Y<145 THEN220 

190 HPUT(X,Y)-(X+22,Y+29).l 

195 Y*Y+10:X=X+W/2 

200 IF X<0 THEN X=0 ELSE IF X>295 

THEN X=295 

205 IF Y>192 THEN 210 ELSE 185 

210 HCOLOR 4: HPRINT(17,8), "Splat 

!P:FOR Z=l TO 5: PLAY T255L255 

OlABCD": NEXT Z:SC=-5 

215 GOTO 280 

220 YY=Y:SC=0 

222 IF X<0 THEN X=0 ELSE IF X>295 

THEN X=295 

225 PLAY"L255T25501CDCDC 

230 Y=Y+2:X=X+W 

240 POKE 343,255:POKE 344,255 

245 Q$=INKEY$ 

250 IF Q$=CHR$(8) THEN X=X-2 

255 IF Q$=CHR$(9) THEN X=X+2 

260 IF X<0 THEN X=0 ELSE IF X>293 

THEN X=293 

263 HPUT(X.Y)-(X+22.Y+29),2 

264 IF Y>155 THEN HCOLOR 5: HUNE 
(TL,186)-(TL+TW,191),PSET,BF 



265 IF Y>157 THEN 275 
270 GOTO 230 

275 IF(INT(X+5))>=TL AND 
(INT(X+17))<=r TL+TW+1 THEN PLAY 
"L3202T2CD EBFAD":SC=INT(YY/12) 

276 IF WF=0 THEN SC^ INT(SC/2) 
280 S=S+SC 

285 HCOLOR 4: HPRINT(0,0), 

w Points=": HPRINT(7.0),SC: 

HPRINT(2 1 f 0), "S cores" : 

HPRINT(27,0).S 

290 JP=JP-1:IF JP=0 THEN 305 

295 HPRINT(13,10), ,, Jumps 

Left=":HPRINT(25,10),JP 

300 FOR Z=l TO 25<XfcNEXT Z;GOTO 115 

?i^!p!i:i:ii 305 HCOLOR4: HPRINT (15, 
10), -Game Over!" 
310 HPRINT(ll,ll) 1 H Play 
Again (Y/N)?" 
315 Q$=INKEY$:IF Q$= 
T THEN GOSUB 405:GOTO 
110 ELSE IF Q$="N" 
THEN POKE65496.0: CLS: 
GOSUB 510:END ELSE 315 
320 GOTO 115 
325 GOSUB 510-.FOR X=0 TO 
15:PALETTE X,SK:NEXT X 
330 HCOLOR 3.0:HSCREEN2 

340 HCIRCLE(25,25),3 

345 HDRAW"BM25,28D2NL3NR3D3NF5NG5 

350 HPAINT(25,25),3,3 

355 HBUFF l,399:HGET(14,ll)-(36, 

40), 1 

360 HDRAWC2BM25,27H7R14G7 

365 HCIRCLE(25,19),7,2,1,.5,0 

370 HPAINT(25,18),2,2 

375 HBUFF 2.359:HGET(14,ll)-(36. 

40). 2 

380 HCLS 

385 HDRAW"C7BM5,0F5R10F5L20U10 

390 HPAINT(7.7)J,7 
395 HDRAWC1BM10/7D2R7E2 
400 HBUFF 3,199:HGET(0,0)-(25, 10) 
, 3 

405 HCOLOR4,0:HCLS 
410 GOSUB 510 

420 HPRINT(12,6), M TARGET JUMPER 
1 M 

425 HPUT(146,80)-(168,109),2 

430 HPRINT(8,39), , 'By Kenneth 

Reighard, Jr.** 

435 FOR X=5 TO 1 STEP -1: PLAY " 
0=X;L45;BAGFDEC;":NEXT X 
440 HPRINT(14,16)."Target Width" 
HPRINT(8,17), w (H)uge (R)egular 
(T)iny" 

450 Q$=INKEY$:IF Q$="H" THEN TW= 
28 ELSE IF Q$="R M THEN TW=20 ELSE 
IF Q$= W T W THEN TW=12 ELSE 450 
460 SOUND 100,1 

470 HPRINT(10,19). ,, Wind (Y)es (N)o 
7 " 

480 Q$=INKEY$:IF Q$="Y" THEN WF= 
-1 ELSE IF Q$= M NTHEN WF=0 ELSE 
480 

490 SOUND 100,1 
500 RETURN 

510 IF MN THEN RGB:SK=11 ELSE 
CMPSK=30 
515 PALETTE 0,SK 
520 RETURN 
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Telecommunications... getting on-line with GEnie... Allen Huffman 



Rub the Lamp.. 

As the final issue of Rainbow made it's way 
into the hands ofloyal Color Computer hobby- 
ists, many of them were left asking the now 
all-too-commonquestion: "Whatnow?" The 
truth is that many of us have been asking 
ourselves that question foryears, yet here we 
are. We are still using our beloved "toy" 
computers and still getting hours of productiv- 
ity and amusement out of this orphaned sys- 
tem. It seems obvious to me that support will 
continue as long as we want it The question 
is where to get support. There are new 
magazines coming out, as well as on-line 
services, such as GEnie and Delphi. The later 
are the fastest means of support. 

Allow me to introduce myself . My name is 
AllenHufEman,andIhavebeenaloyal Color 
Computer user/hacker for about 12 years 
now (yes, my CoCo 1 still runs great, lower- 
case board and hard-wired 64K upgrade 
intact! ). My support-line was nearly severed 
in 1984 when I was relocated from Houston, 
Texas, to a small East Texas town of less than 
300 people. I lost all access to bulletin board 
systems, CoCo clubs, or anyone who even 
had a computer for that matter. Only the 
pages of The Rainbow kept me informed. 

Through The Rainbow I learned of a "new" 
on-line service that F also ft would be working 
with: Delphi. A bulletin board on a massive 
scale where CoCo owners nationwide could 
interact, exchange messages and programs, 
and stay informed. This, sadly, didn't helpme 
since I hadno local access to Delphi. So, after 
several years "lost in the woods ", I relocated 
once again to a larger town. Unfortunately, 
there was still no Delphi access, but mere 
were Color Computer users on local bulletin 
board systems (this was actually before the 
IBM "death grip" had fully taken place and 
these systems ran on Ataris or TRS -80s). At 
one point, half of the systems running in this 
town were actually on CoCos. But those days 
soon ended as the PC-Compatible crowd 
slowly took over. Without local electronic 
support for my platform I decided to look 
elsewhere for help. 

The Lamp is Found-. 
Although there were no major access num- 
bers in my town (no Tymnet, Telenet, etc.) I 
did find out about a lesser-known service 
called GEnie operated by General Electric, 
Surprisingly, it did have a local access num- 
ber. I decided to sign up and have a look and 
seewhat it could offer. Atthis time there was 
actually a fairly active Tandy/TRS-80 area 
(known as a "RoundTable") on GEnie and I 



was surprised to find a small amount of 
activity in the CoCo and OS-9 "Categories". 
I went to work interacting, uploading, and 
doing my best to provoke support A time later 
I found myself taking over a new position - 
that of "COCO-S YSOP" on GEnie. 

GEnie, the General Electric Network for 
Information Exchange, boasts the largest 
amount of access numbers of any on-line 
service. It turns out that the GEIS network 
(which GEnie operates through) is used by 
businesses. This is the reason my small town 
had a number. There are many similar areas 
nationwide with direct dial GEnie "nodes*. 
GEnie further expanded when they began 
allowing access through the SprintNet (for- 
merly Telenet) network. 

GEnie rates are some of the lowest in the 
industry. In 1990 GEnie launched one of the 
first flat rate access fees. In July of 1993 
GEnie adopted a new pricing policy which 
would once again show how strong a con- 
tender in the on-line market they are. Hie 
monmryfee was raised from $4.95 to $8.95 a 
month (US - Canada slightly higher). Also, 
the flat-fee GEnie Basic services are no 
more. But, me good news is that the hourly 
connect charges to GEnie have been dramati- 
cally lowered ! The monthly fee now includes 
four hours of GEnie time and additional hours 
(up to 2400 baud) are billed at S3 an hour! 
Many value services are now covered by this 
fee, such as the Internet mail gateway (no 
sign-up fee to access Internet mail) and com- 
puter databases. Toll free 1-800 access is 
available for $6 an hour extra, as is 9600 baud 
access. In fact, if you use the 1-800 for 
access, GEnie does not even charge higher 
rates for 9600 baud! You can dial in toll free 
at 9600 baud for hourly rates phis $6 extra... 
and since your first four hours are included, 
thinkof GEnie as offering you four 9600 baud 
hours toll free for $6 each. Later hours add up 
to $12 each. 

Unlike some other on-line services, GEnie 
doesn *t charge you "per message" for private 
maiL Youcansendasmanymessagesasyou 
want for $3/hour (and remember, the first 
four hours each month are free). GEnie's 
many multi -player games (like the Hitchhiker's 
Guide-ish Federation II space adventure) are 
$3/hour. Software downloads and the CB 
simulator (conferences), all $3/hour. Hun- 
dreds of services all at your fingertips for low 
hourly rates. 

For Color Computer and OS-9 support, Del- 
phi still has the most to offer. For those 



without access, or those looking for additional 
support or with no local Delphi access, please 
check into GEnie. I'm sure you'll find it has 
something to offer - no matter what your 
interests are. From research to faxes, shop- 
ping to weather maps, the magic of the GEnie 
awaits your discovery. 

Signing Up.- 

You may wish to call GEnie Client Services 
(voice) at 1 1 -800-638-9636 to locate an ac- 
cess number in your area, or simply set your 
terminal parameters to 8/N/l with Half Du- 
plex (self echo) and call 1-800-638-8369. 
Once "CONNECTed" type "HHH" (to "wake 
up" GEnie and letitknow what baudrate you 
are calling at). You will see a H U#= " prompt. 
Here, type in "XTX99188.TANDY" then 
have checking account or credit card infor- 
mation handy and follow the instructions. If 
you are signing up by checking account there 
will be an additional $2/month fee. 

Once your account has been established, 
drop me a note! From any GEnie menu 
prompt, type "MAIL" to get to themailmenu, 
select the "send" option, then address the 
message to "COCO-SYSOP" and let me 
know you Ve made iLl'Il be more than happy 
to help you leam the new system. Feel free 
to check out the Tandy RoundTable - type 
keyword 'TANDY" at any GEnie prompt or 
"M635" to move directly to Page 635, the 
Tandy main menu . 



In addition to being CoCo-sysop on GEnie, 
Allen is the owner of Sub-Etna Software. 




Allen Huffman at the Sub-Etha booth, 
1993 Chicago CoCoFest. Allen is an or- 
dent "Hitchhiker's Guide to the Universe" 
fan. Some may recognize the symbolism of 
the bath robe and towel he typically car- 
ries during a Jest... 
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Telecommunications... Delphi and Internet.. David M. Graham 



Welcome to On-line Currents, your 
guide to on-line sources for the CoCo 
and OS-9. As your host, Til guide you 
to databases on Delphi and the Internet 
This month, we have a number of inter- 
esting files and announcements on 
Delphi. Quite a few in fact. I'll concen- 
trate on Delphi this month, leaving the 
slower posting on our Internet sites for 
next month. 1*11 list these offerings 
under the titles used by the posting 
user/author in the database, adding ex- 
panded descriptions only when needed 
to clarify what the file is, or which 
machine it requires. 

Oh, a bit about myself. I am a registered 
nurse, a full time nursing supervisor, 
and a part-time businessman. I operate 
BlackHawk Enterprises, a company 
which supports, among other things, 
the MM/1, CoCo 3 and other OSK 
computers. It is my intention to remain 
as neutral as possible about the relative 
merits of the competing systems, so 
feel free to send comments if you think 
I've slighted anyone. 

I bought my first Color Computer in 
1981. That CoCo I (F board) ran for 
quite a while as a dual floppy OS-9 
Level 1 system, but was finally re- 
placed with a CoCo 3. My Level 2 OS- 
9 setup included a B&B 30 Meg hard 
drive setup, until my multipak suc- 
cumbed to old age! Prcsendy I get 
along on my MM/1 system. 3 mega- 
bytes of RAM, a 105 meg Hard drive, 
mouse, ViVa 2400 modem and a Star 
NX- 15 printer round out the complete 
system. 

It may seem that I went OS-9 crazy 
early and stayed sold. That is true. But 
rest assured that if there seems to be a 
slant towards OS-9 here, it exists only 
because of the relative activity in the 
two databases that month. My CoCo 3 
remains in use, if rarely, and Til do my 
best to keep you informed! If you want 
to compare systems, you may reach me 
at: 

Delphi: NIMTTZ 

Internet : nimitz@delphi.com 



The Kingdom BBS : The Prince, 
(405) 233-3866, 14.4K Baud, 8-n-l 

Now, on to the databases! In the OS-9 
On-line Databases, we have 17 new 
files. 

PNW CoCoFest Information: Info 
about the Pacific Northwest CoCoFest 
(June 25-26, Port Orchard, WA) 
TED 1.0: Text Editor: An editor for 
the CoCo 3. 

IMASTER 1.40 : An Imagingprpgram 
for the MM/1. Reads IFF, GIF, and 
PCX files, and writes IFF files. Allows 
editing, very nice! 

SCF Edition 14: Combines Kevin Dar- 
ling editor patch with improved sup- 
port for non-sharable devices! 
Multi-Iser CRON: Allows multiple 
crontab files for multiple users. 
Write-Right Availability: Announce- 
ment by BlackHawk Enteiprises 
1993 Chicago Test Report: Joel 
Hegberg's submission of Allen 
Huffman's report 

DF: Disk Free Space Command: By 
TTMKIENTZLE for the CoCo 3 
TAGEDIT: Scribe Tag-line Editor: 
for the CoCo 3, by BIGMILL 
Print to Serial Printer: on the MM/ 
l,by TTMKIENTZLE 
KIX Q&A Info: Information on 
FHOGG's latest OSK machines 
OS9 FAQ, 7th Ed.: Frequently Asked 
Questions, thanks, JSHEPLER 
RELPATCH: Change OS9BOOTCol- 
ors : by MODEL299 for the CoCo 3 
Terminal 100 Aquisition: a news re- 
lease from BlackHawk Enterprise 
CCUNZIP 1.02: CoCo UnZip Pro- 
gram : The latest UnZip program for 
the CoCo 3 by CURTTSBOYLE, with 
RMA source code. 

Write-Right Demo for MM/1: Demo 
version of Joel Hegberg's new word 
processor for the MM/1. 
Neat GIF Demo, JUST VIEW IT!: An 
excellent demo of the features of 
GIF89afonnati5)loadedbyTELENUT. 
DeskJet Printer Graphics Dump: 
ByRICHKOTTKE 

KIX\20 Product Announcement: 
FHOGG announces his newest KIX 
68020 OSK machine at a nice price! 



Found in the CoCo Databases are 5 new 
uploads for May, 1993. They are : 

DEBBIE01: Picture of a scantily clad 
woman, uploaded by TRAS 
Beatles Albums In IMG #2: uploaded 
by DEANHOLDER 
Source for Fast Disk I/O: asm source 
from CHETSIMPSON 
CF83 FORTH: Forth, for DECB up- 
loaded by MDJOHNSON 
COCO BBS List: Thanks to PfflLUPT 

That's it until the next issue. See you 
then! 



How To Get In Touch 
WithDelphi 

There are several ways to get informa- 
tion on Delphi. You can dial 1-800- 
695-4005 (voice) to talk to a represen- 
tative. Alternately, you can dial 1-800- 
695-4002 with you modem (settings 8 
bits, no parity, 1 stop bit). At the PASS- 
WORD prompt, type INFO. Mail may 
also be sent to Delphi via Internet 
(INFO@delphi.com). Delphi can be 
accessed through TymNet and 
SprintNet Call those representatives 
for local access numbers. 



DISTO Products 

Hardware for \our CoCo! 



2MB Upgrade - $99.95 (no RAM) 

Mini Disk Controller - $70 

Super Controller I - $100 

Super Controller II - $130 

MPROM Burner -$50 

3-N-l (parallel, RS232, RTQ - $75 

SASI/SCSI Hard Disk Adapter - $75 

Full Turn of the Screw - book with 

Rainbow articles - $20 

Complete Schematic Set - all DISTO 

schematics except 2MB upgrade - $20 

Include $2 S&H for book or Schematics. 

Hardware S&H is $4.50 for single item, 

$6.50 two or more. Certified check or 

International Money Order only 1 



DISK) 

niOIKI'atic.St.I.aiimil.yC IML 4A8 
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On 26 May 1993, it was reported that Tandy 
sold their computer manufacturing facili- 
ties to rival AST for an undisclosed sum. 
Tandy will continue to sell computer products 
manufactured by others. 

One new item that drew a lot of attention in 
Chicago was a prototype 68000 processor 
board for the CoCo from Burke&Burke 
called the "Rocket" (see cover photo). Un- 
like previous 68000processors for the CoCo, 
this one fits INSDIE the case, not in the 
expansion port. The 6809 must be socketed, 
then the "Rocket" 68000 board plugs into the 
socket. The prototype carried a 68008 (8 bit 
buss), but Chris Burke says the production 
unit will be a 14MHz 68000 1 6 bitprocessor. 
The Rocket carries two SIMM memory sock- 
ets capable of supporting either 1MB or 4MB 
SIMMS for a total of 2 or 8 megabytes of 
memory. The existing CoCo memory is 
access able, but not for applications. It can be 
used for a RAM disk and is also used for video 
memory. In essence, this is a single board 
68000computerconnectedto theCoCo, which 
works like a terminal. For $195 you get the 
Rocket processor board AND Professional 
OS-9/68000, a 6309 emulator, and an OS-9/ 
68000 assembler. With 2MB of RAM the 
price is $295. A very good public domain 
version of C will be available, but due to 
license restrictions it can't be bundled with 
the processor board. A socket for a 68/6309 
is also on the Rocket. This was included 
because the emulator runs at about half the 
speedof OS-9 Level II on a 6809, though the 
emulator will run ina window of OSK (OS-9/ 
68000). To switch processors, one must reset 
the entire machine. If you need to run a Level 
II application, boot with the 68/63 09. If you 
just need to get some information from an 
application while in OSK, run the emulator. 
This looks like a great way to extend the life 
of your existing hardware while getting into 
OSK for a small amount Chris did mention 
that the boards won't be produced unless 
enough interest is shown... please let him 
know if you're interested! 

Burke & Burke also introduced another new 
item- 512 byte sector SCSI device drivers 
for the Disto HDISK and 4-in-l hard drive 
adapters. This allows use of newer, more 
common PC type SCSI hard drives. A head 
parking utility, 256 byte sector drivers, and the 
EZGen bootfile editor are included in the 
$29.95 package. 

Sub-Etha software demonstrated a very good 
looking pull down menuing interface for 
OS-9/6809 and OS-9/68000. This is a com- 
plete system written in C with pull down 
menus and mouse support. The 6809 and 



68000 systems both work alike, meaning easier 
porting of applications between the two. All 
that is needed to add mouse support to pro- 
grams is a call to a library function, which 
comes with the developers system. The best 
thing is that software developers can get a 
system for FREE! Of course there is a small 
catch... Sub-Etna requests the rights to sell 
software that uses this system. Not exclusive 
rights, and they will pay royalties if they 
decide to carry the software. Sounds like a 
reasonable deal! 

Frank Hog Labs introduced the low cost 
Kix20, similar to the Kix30. The Kix20 uses 
a25MHz68020processorinsteadof an 4 030. 
This board was designed to provide a lower 
cost OSK platform for those who couldn't 
afford a Kix30, yet wanted more power and 
flexibility than an MM/1. A Kix20 mother- 
board sells for $699.95 compared to a 1 6MHz 
Kix30moiherboardat$1499.95.Amini tower 
case, power supply, 1 .44MB floppy drive, and 
cable kit adds $249.95 to either motherboard 
(DRAM not included... both support 1 , 4, & 
16MB SIMMs). See the FHL ad in this issue 
for Kix20 motherboard details. 

Microware had a booth at the Middle 
America Test AND the Chicago Test. 
This is not so surprising itself, since the Tests 
typically have a good OS-9/68000 showing 
(Microware no longer supports OS-9/6809). 
Surprising was that they cut the price of OS- 
9000 (OS-9 for Intel 386 or higher proces- 



MicroNews. 



sors) by 60%! During the two days of the 
Tests only, one could purchase OS-9000 for 
only $350! Regular price is near $600. Will 
they show up in Atlanta also? One can only 
hope (or write and ask)! 

Tony DiStefano had a booth in Chicago. He 
was selling a lot of left over DISTO products, 
but also had something new- a 2MB memory 
upgrade for the CoCo 3! Unlike the earlier 
1MB upgrade, this one requires soldering only 
two wires to the motherboard. The upgrade 
consists of two approximately 2" square cir- 
cuit boards, onr for the memory and one for 
access control. The control board plugs into 
the CPU socket, which means one must 
either socket the CPU or piggyback a socket 
over the CPU. Socketing the CPU is the 
better choice, as there is a socket on the 
control board for a CPU, and if the CPU ever 
needs replacing the job is much easier. The 
memory board holds two "three chip" 1MB 
SIMMs. The "three chip" type draws less 



power than the "nine chip" variety. Using 
the nine chip SIMM may work, but could 
c^use serious overheating problems and is not 
recommended Incaseyou wonder if the new 
4MB SIMMs would fit, the CoCo does not 
have the circuitry to support over 1MB and 
adding such would be difficult and expensive. 
The 2MB upgrade sells for $99.95 plus $450 
S&H ($104.45 total). 

HIGH SPEED COCO SERIAL PORT 
57,60(HjpsunderOS-9! Rick inland, owner of 
CoNect, has created something many OS-9 
users have only dreamed of- a serial port that 
doesn't slow them down! The CCIO port 
uses a National Semiconductor 16553 which 
was originally designed for Intel 386 and 486 
I/O boards. The chip is so fast that mating it 
with the comparatively slow CoCo bus re- 
quired some tricky timing circuits. The 16553 
buffers up to 1 6 bytes compared to only one 
byte for the more common Rockwell 6551 
used in most other CoCo serial ports, whic is 
the reason the port is so fast. Two nine pin 
ports and a parallel printer port are mounted 
ma case the size of the original Tandy RS-23 2 
Pack and sells for $130 plus $4 S&H. The 
paralell port has all the circuitry for bi-direc- 
tional operation. Rick hopes to eventually 
write drivers to support the bi-directional 
capability. There is a lot of PC hardware that 
takes advantage of such a paralell port... 

A letter appeared on several Internet sites 
that gives the following E-mail addresses : 
PRESIDENT@WHITEHOUSE.GOV 
VICEPRESIDENT@WHITEHOUSE.GOV 
These are for real! Personal replys won't be 
sent, but receipt of your message will be. 



Burke & Burke, P.O. Box 733 
Maple Valley, WA 98038 
Phone 206-432-1814. 

CoNect, 449 South 90th Street 

WestAllis,WI53214 

Phone414-258-2989 

DISTO, 1710 Depatie 
St. Laurent, QC H4L4A8 
CANADA 

Frank Hogg Laboratory, Inc. 

204 Windemere Road, Syracuse, NY 13205 
Phone3 15-469-7364 

Microware, 1866 N.W. 1 14th Street 
Des Moines, IA 50322 

Sub-Etna Software, P.O. Box 152442 

Lufkm,TX759l5 

Phone409-639-3842/815-748-6638 
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Reviews... 



RASCAN Digiscan Digitizer 

FARNA Systems, Box 321, 
Warner Robins. GA 31099-0321 
912^328-7859 
($145.OO+$20 .00 S&I1) 

Digiscan is, as the name implies, a video digitizer 
for the Color Computer 3 . This hardware/software 
combo was designed and currently manufactured 
in Australia and distributed byFARNA Systems. 

To use the Digiscan hardware you need a 512K 
color computer 3, disk drive, and a video source 
such as a video camera or VCR. Red, green, and 
blue photographic color filters for capturing the 
4096 color and 3-D images with a video camera 
(B&W or monochrome cameras CAN make the 
4096 or 3-D images) are optional and must be 
acquired by the purchaser. 3-D glasses are re- 
quired to view the 3-D images. 

The digiscan hardware itself is only about 2* by 5" 
(much smaller than the original unit!) so it easily 
fits beside your coco. On top of the unit are two 
knobs, one to control the white imaging level and 
one to control the black. Power is supplied to the 
unit by a 9 volt battery which is installed inside the 
unit. A small piece of cardboard should be placed 
between the battery and circuit board to help 
guard against possible shorts. 

Connection to the CoCo is via three DIN plugs; 
one in each joystick port and one in the cassette 
port, so a multi-pak interface is NOT required. 

The software is provided on a flippy disk with the 
Digiscan and printer drivers on one side and some 
sample pictures on the other. Before you start the 
Digiscan software for the first time, you must tell 
it what kind of printer you are using. This is done 
with the included program "Setprint". When you 
run this program it gives you a choice of four 
printer drivers: Epson, IBM, Tandy 105, and the 
Tandy 132. After you make your choice the 
program exits and w/u a default printer file. 



Afterbooting the Digiscan software.the titles 
soon appears and about 15-20 seconds later the 
control panel appears. Users in the USA will need 
to press the *H* key at this point to set the program 
to 6Ghz, as the screen will continue to roll if you 
don't The control panel is nicely done in black and 
white hires graphics and clearly shows all of the 
options available and the current settings. 

There are fourmodes of image capturing to choose 

ftom:320x20Cbtl6cok*i»ode,64Qx 

white, 4096 "Flikpic", and the three dimeniianal 

image capture. I did not have a video camera with 

the color filters so I could not test the 4096 or 3-D 

images, but the grey scale images turn out very 

good (with a little practice). 

The digitizing process is simple but takes some 
practice to get good scans. To digitize an image 
one simply provides a video signal to the Digiscan 
hardware and press * D' from the control paneL A 
thin line starts sweeping from right to left across 



the screen with the image being drawn as the line 
goes by. This is when adjustments can be made 
with the black and white knobs found on the unit 
to get the right brightness and contrast for the 
image. When you are satisfied with the image, 
press <B reak> and it will exit to the control panel 
where the image can be manipulated with the 
features of the control panel such as color editing. 

The manual is a 25 page booklet which fully ex- 
plains the features of the Digiscan software, image 
capturing, the IMG picture format, IMG to CoCo 
Max 3 conversions. For those who are interested 
in writing their own driven, the manual describes 
the control signals from the Digiscan hardware to 
the CoCo and shows me actual software routines. 
Hie manual u well written and should let anyone 
start capturing images within a few minutes. 

I could only find two faults with this software/ 
hardware package. One is the inability to convert 
4096 and 3 -D images to the color sequencing used 
by programs such as The Projector (DECB) or 
View (OS-9). I did eventually find a way to do this, 
but it is rather tedious and time consuming. The 
other fault is that you must set your printer baud 
rate every time you boot instead of saving the 
baud rate with the default printer driver file. 

ThispackageshouldsatisfyanyCoCouser.lt is 
eaiytouse and provi<lei high quality images. This 
review can be summed up in two words: buy it! 

QuinnGranfor 



Color Schematic Designer 3.0 

Radical Electronics, Box 1 350 

Saskatoon, SK S7K 3N9 CANADA 

306-664-8724 

($3500 US., S&H included) 

Where did this program come from? This is version 
3.0, and Tve not heard of it before! The program 
shows it's maturity also It is well written and 
comes with a complete, easy to read manual In 
fact, I was so impressed that I decided to review it 
myselfl 

Color Schematic Designer is a schematic drawing 
program that requires a CoCo 3, hi-res joystick 
adapter, and 5 1 2K. The built in mouse driver has 
user selectable speed and resolution variables. 
This allows the mouse to be tailored to the users 
satisfaction. The cursor moves proportional to the 
position of the mouse. Several keyboard "hot 
keys" are used in conjunction with the mouse. Up 
to 64 electronic symbols can be used in any one 
schematic. A library of 43 ready to use symbols is 
included. Most users wiU find that this set con- 
tains all they need. If not, a symbol editor is 
included for making ones own symbols. 

Tne program is very easy to run. Simply insert the 
program disk and type RUN* BOOT". The default 
screen uses a black background with a blue grid 
and red lettering. Colon may be changed by 
editing a line in BOOT.BAS to reflect the type 
momtorused(RGB,NTSC[TVl,INVersemono- 
chrome, or MONOchrome). Position the mouse 
where you want a symbol, press "S** to go into 



symbol mode, tab through the symbols with the 
clear key, then press enter. The symbol can then 
be rotated in 90 degree increments to the desired 
position and lines drawn between symbols . Multi- 
layer schematics are supported. 

A very useful feature is that the program can be 
exited and reentered without losing data. Press 
break to exit The BASIC command line will appear. 
Any BASIC statement or even a program can be 
run. Programs must not use any memory outside 
the normal 64 KB ASIC area. Writes tolow memory 
will corrupt Color Schematic Designer. The author 
claims that any Disk BASIC command is usable, so 
I exited and formatted a disk, probably the most 
drastic of the commands. At first, I suspected the 
schematic in memory to be gone. The manual says 
to type GOSUB 29000 <enter> then 
RUN"BOOT"<enter> to return to the program. 
Whenltyped GOSUB 29000,1 was greeted with a 
UL (undefined line) error. After running BOOT, 
however, I was asked if I wanted to continue with 
the schematic in memory. I answered "yes", and 
the schematic was still there! DSKINI usually 
trashes any program in memory as it builds a RAM 
image of the disk before formatting. Onemust have 
the program disk in drive to run BOOT. 

Four types of printers are supported: Tandy DMP 
series, standard IBM graphics compatibles, Ep- 
son FX/LX compatibles, and Postscript. The pro- 
gram was designed to use the Epson compatibles, 
as the output is nearly in a 1:1 aspect ratio (1.1:1) 
when using hi-res graphics mode on a standard 
carriage. The wide carriage printer produces a 
perfect 1:1 ratio This ratio is length to height, so 
a 1.1:1 ratio means the item is 1.1" wide for every 
inch talL The standard carriage Tandy DMP print- 
ers produce a 1.4:1 ratio, the IBM graphics a 1.7:1. 
The author claims that between 0.8 and 1 2 there 
will be no noticeable distortion. Quality of output 
is also rated in the manual. An Epson FX/LX 
compatible (standard carriage) in hi-res graphics 
mode rates the best, a Tandy DMP wide carriage 
the worst. The Postscript driver will send a file 
immediately toa Postscript compatible laser printer 
(this was demonstrated at the Chicago CoCoFest) 
or ink jet or to a disk file. The PS disk file can be 
transferred to any other computer with the capa- 
bility of printing a PS file. 

This program is almost a must for any hardware 
designer/tinkerer. Future plans include the release 
of a Printed Circuit Board designer that will pro- 
duce ready to etch output and a PCB Autorouter 
that will route traces between components. These 
two programs require the Color Schematic De- 
signer to work. 

Alan Bayco, owner of Radical Bectromcs, is using 
the CoCo and these programs for his own elec- 
tronics project!. Since he had to write his own 
software, he was considerate enough to offer it to 
the general public at below development costs. 

F.G.Swygert 
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New Lower Prices! 



from ColorSystems 



Variations 
ofSolitaire 

Includes FIVE vahitioni; Pyramid, 
Klondike, Spider, Poker and Cinfidd. 
Complete documentation ihowi 
how to create your own games boot 
disk uiing the speciil menu pro- 
gram which is included. 

CoCo3 Version $29.95 
MMII Vereion $39.95 

WPShel 

A Word Processing Oriented Point 
and Click Shell for all your word pro- 
cessing needs. Requires Windlnt 
from your Mulli-Vue disk. Does not 
include Editor* Formatter, or Spelling 
Checker. 

CoCo3 Only! $20.00 



NEW! 

Using AWK With OS-9 

A description of the AWK Program- 
ming Language with an emphasis 
on GNU AWK for OSK. Includes the 
latest version of GNU AWK. 

OSK ONLY! Just $29J5 

OS-9 Game Pack 

Include* FIVE complete games; Othello, 
Yahtsoe, Minefield, Knighti Bridge, and 
Battleship. Inrlnrt— special menu and atop 
by step instructions an creating your own 
games boot disk, 

CeCeJ Version $29.95 
MM/1 Version $39.95 

All CoCo3 Programs require at 
least 256K of memory. 

Coming SOON! Indexed Files for 

OS-9 Level 2, OS-9/68000, and 

OS-9000! 



We accept Personal Checks or Money 

Orders drawn from US Banks or 

International Postal Money Orders. 

NC residents please add 6% Sales Tax. 

Call or write for FREE catalog! 

Please add S3 per item for shipping 

outside of the Continental United States, 



ColorSystems 

P.O. Box 540 

Castle Hayne, NC 28429 

(916) 675-1706 

Quality OS-9 Software for the Color Computer 3 and the MM/ J from IMS 



Paint version 1.0! 



(Hyper-Tech Software) -$54.00 



This firstcommercial release of the classic PD program included with 
all MM/1 systems now offers file I/O for GIF and BRUN files. Edits 
images of 320 x 200 pictures. BRUN files are compiled into FLI 
animations using tools from the PDCUtils package. This is introductory 
priced, so buy NOW! 



PKUtils 



(Hyper-tech Software) -$19.00 



Includes new and updated MM/1 utils for handing graphics images ! 
AAPlay can now take FLI files apart and SnapIT saves a screen to 
disk in 2 formats. Also included are updated versions of GIFShow, 
GIFtoIFF, IFFShow, and the new CIFF2GIF utility. Once again, buy 
now for low, low introductory prices! 



DESKTOP! 



(Hyper-Tech Software) -$54.00 



A full featured ICON based GUI for the MM/1 ! Including it's own 
icon editor, and taking maximum advantage of theMM/1 windowing 
system this is one sweet system, and the bargain priceing WONT 
LAST! 

BlackHawk Enterprises 

P.O. Box 10552, Enid, OK 73706-0552 

See us for all your OS-9 6809 & 68000 needs! 
Authorized MM/1 Distributor 

AT&T (405) 234-2347 - Internet nimitz@delphi.com 



The Swap Shop 



Buy, sell, or trade hard and soft ware! 

[f you have something you no longer 
leed, need something you can't find, or 
ust have some extra "stuff" lying around, 
his is the place to find or get rid of it! 
Sorry, no complete systems advertised 

3ne year subscribers receive 1 20 words/ 
^ear or two ads free. Six month subscrib- 
rs get 60 words or one free ad. All others 
uy $0.20/word with a $5.00 minimum, 
^ame, address, and phone number are 
r rce. Businesses must inquire first 1 



FPRSALF, 

S4K ECB CoCo 2 - $20, JAM drive 
system - $40. Jason Reighsrd, 441 
fcdgeland Dr.,Toronto, OH 43964 

SAIiEORTRADE 

[ have approximately 24 ne verused Tandy 
~C3 programs for sale or trade for CC3 
ion/hard ware. Send SASE for list John 
l.Mott,Jr., Box 26246, Phoenix, AZ 

S5068-6246 

TRADE 

NOENTKIES 



WANTED 
Used CoCo hard/software. Will buy by 
piece or entire collections. Rick Ulland, 
449 South 90thSt., West Allis,WI53214 

NmroMHnrrcRrc,ATm 

Do you need to add a professional look 
to your software manuals? Need inex- 
pensive typesetting? Publishing your 
ownbook?Prices $8-$l5perpage!Send 
ascription of whatyou needtoFARNA 
SystemsPB f Box321 f WamerRobins,GA 
31099-0321.Phone 912-328-7859 (8- 
1 lam, also weekends). 



Sub-Etha Software 

Box 152442, Luflin, TX 75915 

Quality OS-9 and OSK (MM/1) Software! 

Phone 409-639-3842 



Write-Right - At last! Areal word processor for K- 
Windows! Includes mouse support, WYSIWYG display, 
and all major word processing functions in a graphical 
user environment. 

Etha-GUl - An amazing graphical user interface for any 
K-Windows compatible computer (OSK), Many built-in 
accesories such as notepad, phone book, etc. Point 
and click applications in an instant! 

Check Book Plus - Keyboard or mouse driven check 
book program. Pop-up calculator and graphs! Available 
for OS-9 or OSK. 

Mini Banners - Print single or multiple line banners with 
ANY printer! Over 30 fonts included. Send banner to 
disk, screen, or printer! Available for OS-9 or OSK. 

Write for free catalog! 
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for all your CoCo hardware needs, connect with 

449 South 90th Street 

Milwaukee, WI53214 

414-258-2989 (after 5pm EST) 



CoNect 



Mini RS-232 Port: Don'tletthenamefoolyoulThisisafull 
featured serial port, supporting the signals needed for Dow control as 
well as the basic 4. Jumper blocks allow readdressing or swapping 
DSR/DCD. No custom cables or hardware widgets needed here! Y 
cable users will need to add $9.95 for a power supply. $49.95 

XPander: Don'tyou think the CoCowouldbealotnicerwithout 
all that mess hanging off the right side? Of course it would! Our 
XPander allows mounting two SCS decoded devices (like a floppy 
andharddrivecontToller) inside your CoCo.Built-inno-slot RS-232 
port is similar to our "Mini" described above. The external cartridge 
connector is still present, and can be configured to run games or as 
an additional hardware slot Kit includes new lower case shell and 
12V power supply. Board only is great for use in a PC case! 

Kit: $124.95 Board Only: $99.95 

Hitachifi Cation: CoNect will install a Hitachi 63B09E CPU 
and a socket into your CoCo. Machine MUST be in working 
condition! Hie 68B09E will be returned unharmed. 90 day limited 
warranty. Chip and installation only $29*95 

We also have cables! Ask for a CoNect catalog. 




I'm sure youVe noticed that68' micros is bounda 

littkdiffeimlythanyourusualm^ 

keepmybackissues,aixlhavingu^ 
punctedforconveniemth^ 
betheidealstoragesolution! FARNASystemshas 

1 l/2"bindersavailablewiftanattractivccovaand 

spine Signed specifically for6^' micros. There is 

evenspaceonthewverandspinetomarkthebinder 

contentsIOfderyourstodayforonly 

$6.00 

(shippipg &hancflinginduded) 



FAUNA Systems PB 

Bo.\321 

Warner Robins. GA 3 1 OW-032 1 

Phone 9 12-328-7859 



The C Compiler for the CoCo ha* finally arrived.. 



CoCo-C 



CoCo-C U a compute RSDOS based C development package for the 
Color Computer not requiring the OS-9 Operating System. CoCo-C 
consists of the following programs: 

Text Editor 

A full featured screen oriented line editor for the CoCo 3 developed by 
Bob van der Peel Powerful editing and cursor commands with auto- 
indent and user defined macros make this a great editor for writing C 
or assembly lsnguage programs. A less sophisticated version it 
provided for the CoCo 1/2. 

C Compiler -^ — — 
The CoCo-C Compiler is a full featured K&R style integer compiler 
specifically deiigned for RSDOS based systemi. It has assembly 
language output, position independent cade and can output ROM-able 
code if desired. Added features allow you to mix C, assembly language, 
and BASIC commands within your program! 

Assembler 

This symbolic assembler is capable of aasembling files ai large ai 
available disk space. It supports Motorola style syntax and outputs 
standard binary files ready to LOADM and EXEC. Options include list 
file output and generation of symbol table. 

Library/Linker 

The Library linker is a utility which links the CoCo-Cs 90+ function 

library with your compiled binary file, creating a stand alone executable 

ML file, 

Command Coordinator 

The Command Coordinator is CoCo-C's main program. Its user 

friendly menu driven screen smoothly switches back and forth between 

the Editor, Compiler, Assembler, and linker. 

The CoCo-C Compiler package includesBOTH CoCo 2 and CoCo 3 
versions of ALL the programs Hasted above plus MORE! (Man. 64K) 

NcTtr ptfa* hm ttrcrt bttn in offer like tbbjy UicJPoior Computer! 



Only $59.95 

Plu $4.00 ahlppms * landling 
(check, money order, or COD) 



this for the Color Comni 
Infinitum Technology 

P.O. Box 336 
SaddU River. NJ 07458 



Great Stuff For Your 
OS-9 System! 



We've been in the software business for over 10 

years- and we've developed lots of excellent 
software over that time. We don't have room in 
this space to tell you everything, but we'd love to 
send you our catalog listing all of our products. 
Great stuff like our VED text editor, Vprint text 
formatter, Cribbage, Magazine Index System, 
Ultra Label Maker, Vmail, and more! 

So you only get what you need, please specify 
OS-9 or OS-9/68000. 



Bob van der 

P.O. Box 355 
Porthill, ID 
US 83853 



Poel Software 

P.O. Box 57 

Wynndel, BC 

Canada V0B 2N0 



Phone (604) 866-5772 
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Your Products Should be Here! 



Advertising budget tight? Don't think you can afford to adver- 
tise? Well, you can't sell if you don't! 
You can advertise in "the world of 68* micros" 
for as little as $12 per issue ($10 for subscribers)! 
That how much this 3 3/8"x 13/4" business card ad costs! 
A 3 3/8"x 3 1/2" ad is only $18 ($16 for subscribers). 
See inside front cover for larger ad rates. 

NOTE: TbMo adi limited to fint tune edveitijen mad comptnim with no more than 
two product! m their inventory. Adi may be poiehaaed for vp to four tnaertion*. 



Submitting Material to 68' micros 

FARNA Systems retains rights to print and distribute any 
and all contributions. The submitter retains rights to distrib- 
ute, but not to print in another publication without consent 
of FARNA Systems.. 

We accept program submissions in any programming 
language for DECB and OS-9 (6809 & 68000) of any type 
(games, utilities, etc.). Articles are accepted covering any 
aspect of Motorola 68xx and 68xxx processors. This in- 
cludes microcontroller projects as well as alternate operat- 
ing systems. If there are enough subscribers interested, we 
will begin accepting programs for alternate operating sys- 
tems as well. 

Submissions should be sent on disk in ASCII and execut- 
able formats. A letter desreibing the program or article 
should also be included. Submissions can be made to 
DSRTFOX on Delphi, or dsrtfox@delphi.com via Internet 
Media accepted: 525 " disk in CoCo OS-9 (35/ 40T, SS/DS), IBM 
(DD/HD) , or DECB (35/40 T). 3 J" in IBM only (DD/HD) 



Tandy's Little Wonder 

the MOST COMPLETE refexoice ever written for the Color Computer! 



Softbound book contains: 

- 140 BIG 8 l/2"x 11" Pages 

■ History of the CoCo (25% of content) 

■ Club and BBS Listings 

■ Current Supporting Vendors 

■ Peripheral Details 

■ Operating System Descriptions 

■ ProgrammingLanguages 

■ Repairs 

■ Hardware Upgrades 

■ Schematics 

■ Historic Memoirs 

- MUCH, MUCH MORE! 

ONLY $25 — 

( add $2.50 S&H, $4 Canada, $7 Overseas) 



Say "1 saw it in 68' micros" and get SI ofll 



FARNA Systems PB 

Box 321 
Warner Robins, GA 31099-0321 



Into the future... 

What does the future hold for the Color 
Computer? That is really up to each of 
you (us!) who still uses it Other "or- 
phaned" computers are still alive and 
well, though there are fewer vendors 
and new products for them. As long as 
there are enough supporters, there will 
be CoCo support, both for Disk BASIC 
and OS-9, in this magazine. 

I believe the precedent set at the Pa- 
cific North West CoCoFest may be a 
ready answer to the trend toward 
smaller Tests in general. I believe the 
CoCo has a stronger following than the 
other "orphans", so inviting them to our 
Tests shouldn't be abig problem . Maybe 
some of the other Test organizers will 
look into this in the future. It would 
definitely make a larger gathering, and 
would lower overall costs. 



I had planned a series of articles de- 
scribing possible updates of the Color 
Computer. These would have included 
building an entirely new circuit board 
around a 6309 and a VGA video chip 
set To say that this would be expensive 
would be an understatement! I do be- 
lieve a "kit" with parts and circuit board 
could be assembled for uner $250, but 
some parts would still be required an 
original CoCo 3, like the GIME for 
compatibility and a copy of the ROM. 

The idea of building a new circuit board 
had its merits... until Chris Burke came 
along with the "Rocket" . I've said enough 
about the Rocket elsewhere in this is- 
sue. Suffice it to say now that this 
product cheaply and effectively 
stretches the life of the CoCo. I realize 
it won't help Disk BASIC any, but the 
majority of those sticking with the 
CoCo appear to be interested in OS-9 
more and more. 



If you are a Disk BASIC user only, 
please don't think that you will be aban- 
doned! That is something I do not in- 
tend to do. It has, however, become a 
primary mission of this magazine to 
get anyone who is interested help with 
OS-9. 

OS-9 IS NOT as "easy" to learn as MS- 
DOS to the typical DECB user. MS- 
DOS commands and syntax are close to 
DECB, while OS-9 comes from the 
UNIX world... very different from 
DECB and MS-DOS! 

OS-9, however, is not the only operat- 
ing system available for the 6809 or 
68000. 1 intend to have some coverage 
of these alternate systems, and also of 
some industrial OS-9 applications. They 
should prove interesting. 

Francis G. Swygert 
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FARNA Systems 

Box 321, Warner Robins, GA 31098-0321 
(912)328-7859 - Intemctdiitfox@dclphLconi 
The Color Computer Specialist" 

CoCo Family Recorder 2.0 - $20.00 

The ULTIMATE genealogy program for the CoCo 3. Several repots, info 

gathering sheets, family tree, etc Can print any screen. Up to 550 people, 

300 marriages. Requires two drives and an 80 column monitor. 

OS-9 Quick Reference Guide - $7.50 

Handy 5 l/2"x8 1/2", 42 page reference contains command syntax, special 

keys, editor commands, error codes, and system calls... everything the 

uter or programmer needs in an easy desk size! 



COCO FRIENDS DISK MAGAZINE 



rptogn 
"Pa 



an easy c 

TOT 



atchOS-9 - 

This two disk set contains all the most recommended and helpful patches, 

commands, and utilities that make Twdy'i OS-9 Level II reslly shine! A 

patch program installs all automatically. Two double sided drivei (40 or 80 

track) and 512K (minimum) required for auto patch utility, instructions for 

manual patching on disk also. 

Quick Reference Guide and Patch OS-9.» both for $12! 
RASCAN/DigiScan Video Digitizer - $150.00 

Convert still videoimages to computer images. Process takes about 15 
seconds per screen. Hug* into joystick pons... no MFI requiredl Max- 10, 

CoCo Max 3, and Color Max 3 compatible. Up to 640x200 resolution. 
Special $20handllngfeeappUes, Shipped from Australia, allow 12 weeks 

delivery. 50% down, 50% before delivery. &e review in this issm*I\ 

Cross Road II - hi-res tic-tac-toe with sound! - $10.00 

Mind Games - collection of 9 classic games - $10*00 

Add$2perorderforS*H (Canada $4, others $6) 




CFDM if a monthly disk based po bh es t io n winch is based on a "Hippie" disk. 
When you "run" the "magazine" side of CFDM, you'll be greeted with a 
beautiful cover picture by CoCo Friend James Gibbons. Pressing any key 
takes you to me magazine's colorful Main Menu. Them you'll find 14 section 
which am filled with entries. Sections included are: About CFDM, About this 
Issue. Active CoCo, Advertisements, CoCo Friends Art Gallery, Articles of 
the Month. Family Tree, Forum* From the Editor, Letters to the Editor, 
Potpourri. Programs of the Month, Reviews, and Questions & Answers. 

Next you wffl enter a section and find a number of entries written by our CoCo 
Friends from all over the world. Each issue of CFDM contains 60 to SO 
entries. Some sections contain documentation about the many programs 
and graphics found on the "flip-side" of CFDM. 

Tbe "flip-side" or "program side" of CFDM is filled with contributions of 
wonderful programs and graphics from our many CoCo Friends! Each 
issue has from two to four hi-res pictures and from eight to fifteen never- 
before-seen programs. 

The cost of CFDM is $6 per issue or $30 Cor a six issue subscription. Join 
us now for a lot of fonl If youVe fike me, mere's never too many Friends 
to enjoy a great time on the CoCo. 

ffiNPCAMLCHEm OB MONEY OR DKK TO: 



( Bars 



COMPUTER 
ENTERPRISE 



(606)7*7-57*3 COOsAddSZSO 

P.O. Box 276 
Ubertr,KY 42539 



5 



UPGRADE National Diskletter! 

from: Mid Iowa 4 Country CoCo 
More than a local meet^ wo are a motional reachont! 



QuTUPflRADE* ntffllCttg minfllmilWfthMbecomearealhttw^ 
accompanying articles. Tne article* range from Disk BASIC programrning nad hardware to 
James Jones of Microware, plus an OS tutorial series; dunip to screen (TV, mono, RGB) or 
printer. With new* and editorials from around the community. 

Our Power Packed Domain Ubr«7 is purpos^ 

because the few hundred disks are carefully selected as The Best Available"! Public 

Domain, Shareware, OS-9, and previously big named Orphanware programs. 

We also have a ** Christian Software" sub-chapter which simply offers Christian oriented 
software and listings for those interested. 

Where can you buy or sell that equipment you need or just upgraded from? Your free ads 
will be in the middle of the community . 

Our eight year record speaks very well to reaching out and serving members. A strong 
treasury assures confidence of delivery. With member! from around the country (40f 
states), Canada, and foreign. Our 90% renewal rate says most all feel MIACCC is very 
worthwhile. Join up and be pan of the largest CoCo outreach in p u blic a tion . Your 
membersmpbringsyouthe UPGRADE newalcttcn, libray, voting, and otherprivileges for 
one year. 

MMIowa&Coimtr700>(iioni>romgro^ 
Dp you WMt support t o tu o i i o w TTheaatay with a grtwp mat keeps you in touch! 
Sw w Iaawhm *ctt'mkrr«* and get an UPGRADE disk & bonus disk via return mail! 
ANNUAL MEMBERSHIP: $16\00U^CL00 CAN ADA 



Terry Simons (MI&CCCTi 
132S 48th Stmt 



) 



Des Moines, Iowa S03II 
Phone (515) Z79-2S76 after 840 PM 
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NEW 

LOW COST 

32 BIT COMPUTER 

FOROSK! 

The KiX\20 provides 32 bit pcrfonnance at 16bit 
cost 

The KiX\20 has tfie same 32 bit expansion bus as the 
KiX\30 and uses the same expansion boards. This in- 
cludes the Ultra fast Muld Graphics Adaptor video 
board. The MOA video board adds high end graphics 
to the low cost KiX\20. This combination provides the 
end user with high performance workstation ca- 
pabilities at home computer prices. If you are looking 
for an OSK michine that provides super fast video 
and low cost this is it 

The KiX\20 specs: 

• 25 Mhz 68020 CPU 

• 1, 2, 4, 8 or 16 Meg of RAM on the motherboard 
using SIMM memory. 

• On board SCSI controller (same is KiX\30) 

• Dual density floppy controller. Supports 360K to 
1.4 Meg floppies. All formats supported. 

• 4 Full serial ports. With modem control hardware. 

• 1 KiX\30 32 bit Expansion bus connector 

• Sound part 

• 8K Battery Backed Stalk RAM. 

• 4 on board full serial ports (same as KiX\30) 

• Battery backed Real Time Clock 

• 1 Parallel printer port 

*Fu|l user manual with schematics 

• Autoboot from floppy or hard disk included. 

• 4 Built in I/O expansion bus. 

• 1 Built in 32 bit bus. 
•41ayerPCB 

• Small 8.7 in by 8.7 in. size drops in any PC case 
without modification. 



• Run as a terminal system now, then add a video 
board later. 

• INCLUDES PROFESSIONAL OS9/68000 

• INCLUDES MICROWARE K&R C COMPILER 

• INCLUDES MICROWARE BASIC! 

• INCLUDES MICROWARE MANUALS 

The bus runs at full CPU speed. The bus is not a lim- 
iting factor like the slow AT bus used on most PCs 
available today. (The AT bus is limited to 8Mhz and 
is only 16 bits.) 

Hie performance gain of this system over current sys- 
tems like the TC70 is dramatic. 

In today's economy, cost is a major factor. This sys- 
tem is designed to start at only 699.95. That includes 



"The bus runs at full CPU speed. The bus 
is not a limiting factor like the slow AT 
bus used on most PCs available today.** 



Professional OS9/68000, Microware K&R C compil- 
er, Microware BASIC, deguggers and tons of utilities. 

You can start out with a terminal based system and 
add the MGA video board later. 

The introductory price for the KiX\20 is: 

ONLY $699.95! 

AND that INCLUDES OS9/68000, C and BASICI 



Frank Hogg Laboratory, Inc. 

204 Windemere Road 

Syracuse NY 13205 

Tel: 315/469-7364 

Fax: 315/469-8537 



